streamWrapper::stream_read - Читает из потока
Вернуться к: streamWrapper
streamWrapper::stream_read
(PHP 4 >= 4.3.2, PHP 5, PHP 7)
streamWrapper::stream_read — Читает из потока
Описание
$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() значение при этом игнорируется.
Вернуться к: streamWrapper