streamWrapper::stream_read

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

streamWrapper::stream_read — Read from stream

Descrição

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

This method is called in response to fread() and fgets().

Nota:
Remember to update the read/write position of the stream (by the number of bytes that were successfully read).

Parâmetros

count: How many bytes of data from the current position should be returned.

Valor Retornado

If there are less than count bytes available, return as many as are available. If no more data is available, return either false or an empty string.

Erros

Emite E_WARNING se uma chamada a essa função falha (não implementada, por exemplo).

Nota:
If the return value is longer then count an E_WARNING error will be emitted, and excess data will be lost.

Notas

Nota:
streamWrapper::stream_eof() is called directly after calling streamWrapper::stream_read() to check if EOF has been reached. If not implemented, EOF is assumed.

Aviso

When reading the whole file (for example, with file_get_contents()), PHP will call streamWrapper::stream_read() followed by streamWrapper::stream_eof() in a loop but as long as streamWrapper::stream_read() returns a non-empty string, the return value of streamWrapper::stream_eof() is ignored.

Veja Também

fread() - Leitura binary-safe de arquivo
fgets() - Lê uma linha de um ponteiro de arquivo

add a note

User Contributed Notes

There are no user contributed notes for this page.