mixed fscanf ( resource $handle , string $format [, string $var1 ] )

Name	Beschreibung
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.

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.

Die Funktion fscanf() ist sscanf() ähnlich, wobei sie ihren Input aus der mit handle angegebenen Datei nimmt, und entsprechend dem angegebenen format interpretiert. Sind nur 2 Parameter angegeben, werden die analysierten Werte als Array zurückgegeben. Werden auch optionale Parameter übergeben, gibt die Funktion die Anzahl der ermittelten Werte zurück. Die optionalen Parameter müssen referenziert übergeben werden.

Irgendwelche Whitespace-Zeichen (z.B. Leerzeichen, Tabulator, etc.) im Format String gelten mit irgendwelchen Whitespace-Zeichen des Input-Streams als übereinstimmend. Das heisst, dass auch ein Tabulator /t im Format String mit einem einzigen Leerzeichen im Input-Stream als übereinstimmend gelten kann.

(PHP 4 >= 4.0.1, PHP 5, PHP 7)

Vor PHP 4.3.0 war die maximale Anzahl der von der Datei eingelesenen Zeichen 512 (oder bis zu dem ersten \n, was zuerst eintrat). Seit PHP 4.3.0 werden beliebig lange Zeilen gelesen und interprtiert.

<?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);
?>

users.txt

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

<?PHP
//Inhalt der Datei member.txt:
/*Damir Enseleit 1971
Karl Mustermann 1970
Petra Mustermann 1972*/

$fp = fopen ( 'member.txt', 'r' );
while ( $data = fscanf ( $fp, '%s %s %s' ) )
{
  list ( $vorname, $nachname, $jahr ) = $data;
  echo 'Vorname: ' . $vorname . '<br>';
  echo 'Nachname: ' . $nachname . '<br>';
  echo 'Jahrgang: ' . $jahr . '<br><br>';
}

fclose ( $fp );
?>