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

# streamWrapper::stream_read

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

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

### Описание

public function 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() - Получает строку из указателя на файл

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open