(PHP 4 >= 4.3.0)
stream_get_meta_data -- Recupera meta datos/cabeceras desde apuntadores a secuencias/archivosDevuelve 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 de lectura.
Los siguientes items fueron agregados en PHP 4.3:
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 Apéndice J para más información sobre las envolturas.
wrapper_data (mixed) - datos específicos de envoltura adjuntos a esta secuencia. Vea Apéndice J 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. Los filtros en la actualidad carecen de documentación.
Nota: Esta función fue introducida en PHP 4.3, 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 y versiones posteriores, socket_get_status() es un alias de esta función.
Nota: Esta función NO trabaja sobre sockets creados por la Extensión de sockets.
Los siguientes ítems fueron agregados en PHP 5.0:
mode (string) - el modo (o permisos) de la URI asociada con ésta secuencia.
seakable (bool) - si la secuencia actual puede ser reubicada.
uri (string) - el nombre de archivo/URI asociado con ésta secuencia.