stream_get_meta_data

(PHP 4 >= 4.3.0, PHP 5)

stream_get_meta_data — Извлекает заголовок/метаданные из потоков/файловых указателей


Описание

array stream_get_meta_data ( resource $stream )

Возвращает информацию о существующем потоке stream.


Список параметров

stream

Переменная stream может быть любым потоком, созданным при помощи функций fopen(), fsockopen() и pfsockopen().


Возвращаемые значения

Получаемый массив содержит следующие элементы:

  • timed_out (bool) - TRUE если поток превысил время ожидания данных во время последнего вызова функции fread() или fgets().
  • blocked (bool) - TRUE если поток находится в режиме блокирующего ввода-вывода. Смотрите функцию stream_set_blocking().
  • eof (bool) - TRUE если поток достиг конца файла. Заметьте, что для потоков типа socket этот член может быть равен TRUE даже когда unread_bytes не равно нулю. Для того, чтобы определить есть ли ещё данные для чтения, используйте feof() вместо чтения этого элемента.
  • unread_bytes (int) - количество байт, находящихся сейчас в собственном внутреннем буфере PHP.

    Замечание: Вы не должны использовать это значение в скрипте.

  • stream_type (string) - метка, описывающая внутреннюю реализацию потока.

  • wrapper_type (string) - метка, описывающая реализацию обёртки протокола, наложенного на поток. Смотрите раздел Поддерживаемые протоколы и обработчики (wrappers) для подробной информации об обёртках.
  • wrapper_data (mixed) - специфические для обёртки данные, прикреплённые к этому потоку. Смотрите раздел Поддерживаемые протоколы и обработчики (wrappers) для подробной информации об обёртках и их данных.
  • filters (array) - массив, содержащий названия всех фильтров, который были наложены на этот поток. Документация по фильтрам может быть найдена в Приложении по фильтрам.
  • mode (string) - тип доступа, требуемый для этого потока (смотрите таблицу 1 в описании функции fopen())
  • seekable (bool) - можно ли перемещаться по текущему потоку.
  • uri (string) - URI/имя файла, связанное с этим stream.



Смотрите также:
Описание на ru2.php.net
Описание на php.ru