stream_get_meta_data

Descripción

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.