stream_get_contents - Читает оставшуюся часть потока в строку
Вернуться к: Функции для работы с потоками
stream_get_contents
(PHP 5, PHP 7)
stream_get_contents — Читает оставшуюся часть потока в строку
Описание
$handle
[, int $maxlength
= -1
[, int $offset
= -1
]] )
Похожа на функцию file_get_contents(), за исключением того, что
stream_get_contents() работает с уже открытым
ресурсом потока и возвращает оставшуюся часть содержимого в строку размером до
maxlength
байт и начиная с указанного смещения
offset
.
Список параметров
-
handle
(resource) -
Ресурс потока (например, полученный при помощи функции fopen())
-
maxlength
(integer) -
Максимальное количество байт для чтения. По умолчанию -1 (прочитать весь оставшийся буфер).
-
offset
(integer) -
Перейти к указанному смещению перед чтением. Если это число отрицательное, то переход не произойдёт и чтение начнётся с текущей позиции.
Возвращаемые значения
Возвращает строку или FALSE
в случае возникновения ошибки.
Список изменений
Версия | Описание |
---|---|
5.1.0 |
Был добавлен параметр offset .
|
Примеры
Пример #1 Пример использования stream_get_contents()
<?php
if ($stream = fopen('http://www.example.com', 'r')) {
// вывести всю страницу начиная со смещения 10
echo stream_get_contents($stream, -1, 10);
fclose($stream);
}
if ($stream = fopen('http://www.example.net', 'r')) {
// вывести первые 5 байт
echo stream_get_contents($stream, 5);
fclose($stream);
}
?>
Примечания
Замечание: Эта функция безопасна для обработки данных в двоичной форме.
Смотрите также
- fgets() - Читает строку из файла
- fread() - Бинарно-безопасное чтение файла
- fpassthru() - Выводит все оставшиеся данные из файлового указателя
Вернуться к: Функции для работы с потоками