PHP 8.3.4 Released!

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() - Читает строку из файла

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top