(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
fscanf — Analiza un archivo según un formato
La función fscanf() es similar a la función
sscanf(), excepto que toma un archivo como entrada,
representado por el recurso stream
e interpreta
la entrada según el formato format
especificado.
Todos los caracteres en blanco de la cadena de formato corresponden
a tantos espacios en el flujo de entrada. Esto significa que una tabulación
(\t
) en la cadena de formato puede reemplazar
un espacio simple en el flujo de entrada.
Cada llamada a la función fscanf() lee una línea del archivo.
stream
Resource que apunta a un fichero del sitema que normalmente es creado usando fopen().
format
The interpreted format for string
, which is
described in the documentation for sprintf() with
following differences:
F
, g
, G
and
b
are not supported.
D
stands for decimal number.
i
stands for integer with base detection.
n
stands for number of characters processed so far.
s
stops reading at any whitespace character.
*
instead of argnum$
suppresses
the assignment of this conversion specification.
vars
Los valores opcionales a asignar.
Si solo se pasan 2 argumentos a la función, el valor analizado será devuelto en forma de un array. Si se pasan argumentos opcionales, la función devolverá el número de valores asignados. Los argumentos opcionales deben ser pasados por referencia.
Si se esperan más subcadenas en el format
de las disponibles en string
,
null
será devuelto. En otros casos de error, false
será devuelto.
Ejemplo #1 Ejemplo con fscanf()
<?php
$handle = fopen("users.txt", "r");
while ($userinfo = fscanf($handle, "%s\t%s\t%s\n")) {
list ($name, $profession, $countrycode) = $userinfo;
//... procesamiento de datos
}
fclose($handle);
?>
Ejemplo #2 Contenido del archivo users.txt
javier argonaut pe hiroshi sculptor jp robert slacker us luigi florist it