stream_get_contents
(PHP 5, PHP 7, PHP 8)
stream_get_contents — Читає частину потоку, що залишилася, в рядок
Опис
stream_get_contents(resource $stream, ?int $length = null, int $offset = -1): string|false
Похожа на функциюfile_get_contents(), за винятком того, що stream_get_contents() працює з уже відкритим ресурсом потоку і повертає решту вмісту в рядок розміром до length байт і починаючи із зазначеного зміщення offset
Список параметрів
stream(resource)
Ресурс потоку (наприклад, отриманий за допомогою функції fopen()) .
length(int)
Максимальна кількість байт для читання. За замовчуванням null (прочитати весь буфер, що залишився).
offset(int)
Перейти до зазначеного усунення перед читанням. Якщо це число негативне, перехід не відбудеться і читання почнеться з поточної позиції.
Значення, що повертаються
Повертає рядок або **false**в случае возникновения ошибки.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | length тепер допускає значення null. |
Приклади
Приклад #1 Приклад використання stream_get_contents()****
Примітки
Зауваження: Ця функція безпечна для обробки даних у двійковій формі.
Зауваження :
При указании значения параметра
length, відмінного від **null**ця функція негайно виділить внутрішній буфер такого розміру, навіть якщо фактичний вміст буде значно коротшим.
Дивіться також
- fgets() - Читає рядок із файлу
- fread() - Бінарно-безпечне читання файлу
- fpassthru() - Виводить всі дані з файлового покажчика, що залишилися.