Читает оставшуюся часть потока в строку

Описание

string stream_get_contents ( resource $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() - Выводит все оставшиеся данные из файлового указателя