fgets

(PHP 3, PHP 4 >= 4.0.0)

fgets -- Lê a linha de um ponteiro de arquivo

Descrição

string fgets (int fp, int comprimento)

Retorna uma string com até comprimento - 1 bytes lidos do arquivo apontado por fp. A leitura acaba quando comprimento - 1 bytes foram lidos, em uma nova linha (newline) (que é incluida no valor retornado), ou em um fim de arquivo (eof) (o que acontecer primeiro).

Se um erro ocorrer, retorna FALSE.

Equivocos comuns:

Pessoas acostumadas a semantica do fgets em 'C' devem notar a diferenca em como o fim do arquivo (eof) é retornado.

O ponteiro para o arquivo deve ser válido e deve apontar para um arquivo aberto com sucesso por fopen(), popen(), ou fsockopen().

Um simples exemplo segue:

Exemplo 1. Lendo um arquivo linha a linha


$fd = fopen ("/tmp/arquivodeentrada.txt", "r");
while (!feof ($fd)) {
    $buffer = fgets($fd, 4096);
    echo $buffer;
}
fclose ($fd);
      

Veja também fread(), fopen(), popen(), fgetc(), fsockopen(), e socket_set_timeout().