PHP 8.3.4 Released!

streamWrapper::stream_read

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

streamWrapper::stream_readLê dados do fluxo

Descrição

public streamWrapper::stream_read(int $count): string|false

Este método é chamado em resposta a fread() e fgets().

Nota:

Lembre-se de atualizar a posição de leitura/escrita do fluxo (com o número de bytes lidos com sucesso).

Parâmetros

count

Quantos bytes de dados da posição atual devem ser retornados.

Valor Retornado

Se houver menos bytes disponíveis que count, devem ser retornados quantos estiverem disponíveis. Se não houver mais dados, uma string vazia deve ser retornada. Para sinalizar que a leitura falhou, false deve ser retornado.

Erros/Exceções

Emite um E_WARNING se a chamada a este método falhar (ou seja, não implementado).

Nota:

Se o valor de retorno for maior que count, um aviso E_WARNING será emitido, e os dados excedentes serão perdidos.

Notas

Nota:

streamWrapper::stream_eof() é chamado diretamente após a chamada a streamWrapper::stream_read() para verificar se EOF foi alcançado. Se não implementado, EOF é assumido.

Aviso

Ao ler todo o arquivo (por exemplo, com file_get_contents()), o PHP irá chamar streamWrapper::stream_read() seguido por streamWrapper::stream_eof() em um loop, mas enquanto streamWrapper::stream_read() retornar uma string não vazia, o valor de retorno de streamWrapper::stream_eof() será ignorado.

Veja Também

  • fread() - Leitura de arquivo segura para binário
  • fgets() - Lê uma linha de um ponteiro de arquivo

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top