Descripción
array
stream_get_meta_data ( resource secuencia)
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 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 L para
más información sobre las envolturas.
wrapper_data (mixed) - datos
específicos de envoltura adjuntos a esta secuencia. Vea
Apéndice L 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.
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.
