(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::stream_read — Lê dados do fluxo
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).
countQuantos bytes de dados da posição atual devem ser retornados.
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.
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 avisoE_WARNINGserá emitido, e os dados excedentes serão perdidos.
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.
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.