Читает из потока


(PHP 4 >= 4.3.2, PHP 5)

streamWrapper::stream_readЧитает из потока

Описание

public string streamWrapper::stream_read ( int $count )

Этот метод вызывается в результате вызова функций fread() и fgets().

Замечание:

Не забывайте обновлять позицию чтения/записи в потоке (на число успешно прочитанных байт).

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

count

Сколько байт данных от текущей позиции требуется вернуть.

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

Если в потоке имеется меньше байт, чем count, нужно возвращать столько, сколько доступно. Если доступных данных больше нет, нужно вернуть либо FALSE, либо пустую строку.

Ошибки

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

Замечание:

Если возвращаемое значение будет больше, чем count, то будет вызвана ошибка E_WARNING, и данные свыше указанного количества будут утеряны.

Примечания

Замечание:

streamWrapper::stream_eof() вызывается сразу после вызова streamWrapper::stream_read(), чтобы проверить, достигнут ли конец файла EOF. Если метод не реализован, то полагается, что конец файла EOF достигнут.

Внимание

При чтении файла целиком (например, функцией file_get_contents()), PHP будет вызываеть streamWrapper::stream_read() и вместе с ним streamWrapper::stream_eof() в цикле, пока streamWrapper::stream_read() возвращает непустую строку. Возвращаемое из streamWrapper::stream_eof() значение при этом игнорируется.

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

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