streamWrapper::stream_read

(PHP 4 >= 4.3.2, PHP 5)

streamWrapper::stream_readRead from stream

Описание

public string streamWrapper::stream_read ( int $count )

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

Замечание:

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

Список параметров

count

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

Возвращаемые значения

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.

Ошибки

Вызывает ошибку уровня E_WARNING, если вызов к этому методу не удался (например, не реализован).

Замечание:

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

Примечания

Замечание:

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

Внимание

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.

Смотрите также

  • fread() - Бинарно-безопасное чтение файла
  • fgets() - Читает строку из файла


Участник рейтинга Тэглайн 2010