(PHP 4 >= 4.3.0, PHP 5)
stream_get_meta_data — Recupera meta datos/cabeceras desde apuntadores a secuencias/archivos
Devuelve información sobre una secuencia existente. La secuencia puede ser cualquiera creada por fopen(), fsockopen() y pfsockopen(). La matriz resultante contiene los siguientes items:
timed_out (bool) - TRUE si la secuencia ha superado el tiempo de espera máximo mientras esperaba datos en el último llamado a fread() o fgets().
blocked (bool) - TRUE si la secuencia se encuentra en modo de bloqueo de E/S. Vea stream_set_blocking().
eof (bool) - TRUE si la secuencia ha alcanzado el final del archivo. Note que para secuencias de socket, este miembro puede ser TRUE incluso cuando unread_bytes es diferente de cero. Para determinar si hay más datos para ser leidos, use feof() en lugar de leer este item.
unread_bytes (int) - el número de bytes contenidos actualmente en el búfer interno de PHP.
Note: Este valor no debe ser usado en un script.
Los siguientes items fueron agregados en PHP 4.3.0:
stream_type (string) - una etiqueta que decribe la implementación de bajo nivel de la secuencia.
wrapper_type (string) - una etiqueta que describe la implementación de envoltura de protocolo que cubre a la secuencia. Vea Lista de Protocolos/Envolturas Soportadas para más información sobre las envolturas.
wrapper_data (mixed) - datos específicos de envoltura adjuntos a esta secuencia. Vea Lista de Protocolos/Envolturas Soportadas para más información sobre las envolturas y sus datos de envoltura.
filters (array) - una matriz que contiene los nombres de cualquier filtro que esté apilado para esta secuencia. La documentación sobre los filtros puede encontrarse en el apéndice de Filtros.
Note: Esta función fue introducida en PHP 4.3.0, pero anteriormente, socket_get_status() podía ser usado para recuperar los primeros cuatro items, para secuencias basadas en sockets únicamente.
En PHP 4.3.0 y versiones posteriores, socket_get_status() es un alias de esta función.
Note: Esta función NO trabaja sobre sockets creados por la Extensión de sockets.
Los siguientes ítems fueron agregados en PHP 5.0.0:
mode (string) - el tipo de acceso requerido para esta secuencia (vea la Tabla 1 de la referencia sobre fopen())
seekable (bool) - si la secuencia actual puede ser reubicada.
uri (string) - el nombre de archivo/URI asociado con esta secuencia.