ConFoo 2025

streamWrapper::stream_read

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

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

Описание

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

Этот метод вызывается в процессе выполнения функций 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() - Получает строку из указателя на файл

Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top