PHP Portal » PHP Handbuch » sscanf

Werbung

sscanf


(PHP 4 >= 4.0.1, PHP 5)

sscanfÜberträgt einen String in ein angegebenes Format

Beschreibung

mixed sscanf ( string $str , string $format [, mixed &$... ] )

Die Funktion sscanf() ist das Eingabegegenstück zu printf(). sscanf() liest den String str und interpretiert ihn entsprechend dem übergegebenen format -Parameter , der in der Dokumentation zu sprintf() näher beschrieben ist.

Beliebige Whitespaces im Formatstring entsprechen beliebigen Whitespaces im Inputstring. Das heißt, dass auch ein Tabulator \t im Formatstring einem einzelnen Leerzeichen des Inputstrings entsprechen kann.

Parameter-Liste

str

Der zu parsende Eingabestring.

format

Das interpretierte Format für str , wie es in der Dokumentation zu sprintf() beschrieben ist.

...

Optionale als Referenz übergebene Variablen, die die geparsten Werte enthalten.

Rückgabewerte

Werden nur 2 Parameter an die Funktion übergeben, werden die analysierten Werte als Array zurückgegeben. Andernfalls, wenn optionale Parameter übergeben wurden, gibt die Funktion die Anzahl der ermittelten Werte zurück. Die optionalen Parameter müssen als Referenz übergeben werden.

Beispiele

PHP Code
1
2
3
4
5
6
7
8
// Ermittlung der Serien-Nr. list($serial) = sscanf("SN/2350001", "SN/%d"); // und des Herstellungsdatums $mandate = "Januar 01 2000"; list($monat, $tag, $jahr) = sscanf($mandate, "%s %d %d"); echo "Das Teil $serial wurde hergestellt am: " . "$jahr-" . substr($monat, 0, 3) . "-$tag\n";

Werden optionale Parameter übergeben, gibt die Funktion die Anzahl der ermittelten Werte zurück.

PHP Code
1
2
3
4
5
6
7
8
// Auslesen der Autoren-Info und Erzeugung eines DocBook-Eintrages $auth = "24\tLewis Carroll"; $n = sscanf($auth, "%d\t%s %s", $id, $first, $last); echo "<author id='$id'> <firstname>$first</firstname> <surname>$last</surname> </author>\n";

Siehe auch

  • fscanf() - Interpretiert den Input einer Datei entsprechend einem angegebenen Format
  • printf() - Gibt einen formatierten String aus
  • sprintf() - Gibt einen formatierten String zurück