fscanf

(PHP 4 >= 4.0.1, PHP 5)

fscanf — Analiza la entrada desde un archivo de acuerdo a un formato

Descripción

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

La función fscanf() es similar a sscanf(), excepto que toma su entrada desde un archivo asociado con handle e interpreta la entrada de acuerdo al parámetro format especificado, que es descrito en la documentación de sprintf().

Cualquier espacio en blanco en la cadena de formato coincide con cualquier espacio en blanco en el flujo de entrada. Esto significa que incluso una tabulación \t en la cadena de formato puede coincidir con un simple caráter espacio en el flujo de entrada.

Cada llamada a fscanf() lee una línea del archivo.

Parámetros

handle: Resource que apunta a un fichero del sitema que normalmente es creado usando fopen().
format: El formato especificado como se describe en la documentación de sprintf().
...: Los valores opcionales asignados.

Valores devueltos

Si sólo se pasaron dos parámetros a esta función, los valores analizados serán devueltos como una matriz. De otro modo, si se pasaron los parámetros opcionales, la función devolverá el número de valores asignados. Los parámetros opcionales pueden ser pasados por referencia.

Ejemplos

Ejemplo #1 Ejemplo de fscanf()


<?php
$gestor = fopen("usuarios.txt", "r");
while ($userinfo = fscanf($gestor, "%s\t%s\t%s\n")) {
    list ($nombre, $profesión, $código_país) = $userinfo;
    //... hacer algo con los valores
}
fclose($gestor);
?>

Ejemplo #2 Contenido de usuarios.txt

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

Ver también

fread() - Lectura de un fichero en modo binario seguro
fgets() - Obtiene una línea desde el puntero a un fichero
fgetss() - Obtiene un línea desde un puntero a un archivo y elimina las etiquetas HTML
sscanf() - Interpreta un string de entrada de acuerdo con un formato
printf() - Imprimir una cadena con formato
sprintf() - Devuelve un string formateado