fscanf

(PHP 4 >= 4.0.1, PHP 5)

fscanf -- Interpreta a leitura de um arquivo de acordo com um formato

Descrição

mixed fscanf ( resource handle, string formato [, string var1] )

A função fscanf() é semelhante a sscanf(), mas usa como entrada um arquivo associado com handle e interpreta a entrada de acordo com o formato especificado. Se somente dois parametros forem passados para a função, os valores interpretados serão retornados como um array. De outro modo, se parametros opcionais são passados a função irá retornar o número de valores utilizados. Os parametros opcionais tem que ser passados por referência.

Qualquer espaço em branco na string formato baterá quaisquer outros espaços no stream de entrada. Isto significa que qualquer tabulação \t na string formato poderá bater com um caracter de espaço simples no stream de entrada.

Exemplo 1. Exemplo do fscanf()

<?php
$handle
= fopen ("users.txt","r");
while (
$userinfo = fscanf ($handle, "%s\t%s\t%s\n")) {
    list (
$name, $profission, $countrycode) = $userinfo;
    
//... fazer algo com os valores
}
fclose($handle);
?>

Exemplo 2. users.txt

javier  argonauta        pe
hiroshi escultor         jp
robert  tradutor us
luigi   florista it

Nota: Antes do PHP 4.3.0, o maior número de caracteres lidos do arquivo era 512 (ou o primeiro \n, o que viesse primeiro). A partir do PHP 4.3.0, qualquer número longo pode ser lidos e interpretados.

Veja também fread(), fgets(), fgetss(), sscanf(), printf() e sprintf().