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.

  Nota: Este valor no debe ser usado en un script.

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 M para más información sobre las envolturas.

• wrapper_data (mixed) - datos específicos de envoltura adjuntos a esta secuencia. Vea Apéndice M 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.

Los siguientes ítems fueron agregados en PHP 5.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 ésta secuencia.