Lê dados do fluxo

# streamWrapper::stream_read

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

streamWrapper::stream_read — Lê dados do fluxo

### Descrição

public function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open