Interpretiert den Input einer Datei entsprechend einem angegebenen Format

Beschreibung

fscanf ( resource $handle , string $format [, mixed &$... ] ) : mixed

Die Funktion fscanf() ist ähnlich zu sscanf(), wobei sie ihren Input aus der mit handle angegebenen Datei liest, und entsprechend dem angegebenen format interpretiert. Der format Parameter is unter der sprintf() Funktion näher dokumentiert.

Beliebige Whitespace-Zeichen (z.B. Leerzeichen, Tabulator, etc.) im Format String gelten mit beliebigen Whitespace-Zeichen des Input-Streams als übereinstimmend. Das heißt, dass auch ein Tabulator \t im Format String mit einem einzigen Leerzeichen im Input-Stream als übereinstimmend gelten kann.

Jeder fscanf() Aufruf liest eine Zeile aus der Datei aus.

Parameter-Liste

handle: Eine Dateisystemressource (resource), wie sie in der Regel von fopen() zurückgegeben wird.
format: Das erwartete Format, wie es in der sprintf() Dokumentation beschrieben ist.
...: Optionale als Referenz übergebene Variablen, in welche die geparsten Werte geschrieben werden sollen.

Rückgabewerte

Wenn nur zwei Parameter an die Funktion übergeben wurden, werden die geparseten Werte in einem Array zurückgegeben. Andernfalls gibt die Funktion die anzahl der zugewiesenen Werte zurück. Die optionalen Parameter müssen per Referenz übergeben werden.

Beispiele

Beispiel #1 fscanf() Beispiel


<?php
$handle = fopen("users.txt", "r");
while ($userinfo = fscanf($handle, "%s\t%s\t%s\n")) {
    list ($name, $profession, $countrycode) = $userinfo;
    // Tue etwas mit den Werten ...
}
fclose($handle);
?>

Beispiel #2 Inhalt der users.txt Datei

javier  argonaut        pe
hiroshi sculptor        jp
robert  slacker us
luigi   florist it

Siehe auch

fread() - Liest Binärdaten aus einer Datei
fgets() - Liest eine Zeile von der Position des Dateizeigers
fgetss() - Liest eine Zeile von der Position des Dateizeigers und entfernt HTML Tags.
sscanf() - Überträgt einen String in ein angegebenes Format
printf() - Gibt einen formatierten String aus
sprintf() - Gibt einen formatierten String zurück