streamWrapper::stream_read
(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::stream_read — Lê dados do fluxo
Descrição
Este método é chamado em resposta a fread() e fgets().
Note:
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).
Note:
Se o valor de retorno for maior que
count, um avisoE_WARNINGserá emitido, e os dados excedentes serão perdidos.
Notas
Note:
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.
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.