array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'splfileobject.fscanf.php', 1 => 'SplFileObject::fscanf', 2 => 'Analisa a entrada do arquivo de acordo com um formato', ), 'up' => array ( 0 => 'class.splfileobject.php', 1 => 'SplFileObject', ), 'prev' => array ( 0 => 'splfileobject.fread.php', 1 => 'SplFileObject::fread', ), 'next' => array ( 0 => 'splfileobject.fseek.php', 1 => 'SplFileObject::fseek', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/spl/splfileobject/fscanf.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

SplFileObject::fscanf

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

SplFileObject::fscanf — Analisa a entrada do arquivo de acordo com um formato

Descrição

public SplFileObject::fscanf(string $format, mixed &...$vars): array|int|null

Lê uma linha do arquivo e a interpreta de acordo com o format especificado.

Qualquer espaço em branco na string format corresponde a qualquer espaço em branco na linha do arquivo. Isso significa que até mesmo um tab (\t) na string de formato pode corresponder a um único caractere de espaço na sequência de entrada.

Parâmetros

format

O formato interpretado para string, que é descrito na documentação para sprintf() com as seguintes diferenças:

  • A função não reconhece a localidade.
  • F, g, G e b não são suportados.
  • D significa número decimal.
  • i significa inteiro com detecção de base.
  • n representa o número de caracteres processados até o momento.
  • s pára de ler em qualquer caractere de espaço em branco.
  • * em vez de argnum$ suprime a atribuição desta especificação de conversão.

vars

Os valores atribuídos opcionais.

Valor Retornado

Se apenas um parâmetro for passado para este método, os valores analisados serão retornados como uma array. Caso contrário, se parâmetros opcionais forem passados, a função retornará o número de valores atribuídos. Os parâmetros opcionais devem ser passados por referência.

Exemplos

Exemplo #1 Exemplo de SplFileObject::fscanf()

<?php
$file = new SplFileObject("misc.txt");
while ($userinfo = $file->fscanf("%s %s %s")) {
list ($name, $profession, $countrycode) = $userinfo;
// Faça algo com $name $profession $countrycode
}
?>

Conteúdo de users.txt

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

Veja Também