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() значення у своїй ігнорується.