stream_filter_prepend

(PHP 4 >= 4.3.0, PHP 5)

stream_filter_prepend -- Adjuntar un filtro a una secuencia

Descripción

resource stream_filter_prepend ( resource secuencia, string nombre_filtro [, int lectura_escritura [, mixed parametros]] )

Agrega el nombre_filtro a la lista de filtros adjuntos a la secuencia. Este filtro será añadido con los parametros especificados al comienzo de la lista y por lo tanto será llamado al inicio de las operaciones de secuencia. Para añadir un filtro al final de la lista, use stream_filter_append().

Por defecto, stream_filter_prepend() adjuntará el filtro a la cadena de filtros de lectura si el archivo fue abierto para lectura (esto quiere decir, Modo del Archivo: r, o +). El filtro será adjunto también a la cadena de filtros de escritura si el archivo fue abierto para escritura (esto quiere decir, Modo del Archivo: w, a, o +). Las constantes STREAM_FILTER_READ, STREAM_FILTER_WRITE, o STREAM_FILTER_ALL también pueden ser pasadas al parámetro lectura_escritura para sobrescribir este comportamiente. Vea stream_filter_append() para consultar un ejemplo de éste parámetro.

A partir de PHP 5.1.0, esta función devuelve un recurso que puede ser usado para referirse a esta instancia de filtro durante una llamada a stream_filter_remove(). Antes de PHP 5.1.0, esta función devuelve TRUE en caso de éxito o FALSE si ocurre un error.

Cuando se usan filtros personalizados (de usuario): La función stream_filter_register() debe ser llamada primero para registrar el filtro de usuario deseado para nombre_filtro.

Nota: Los datos de las secuencias son leídos desde los recursos (tanto locales como remotos) en paquetes, usando búferes internos para almacenar datos sin consumir. Cuando un nuevo filtro es agregado al inicio de la lista de filtros en una secuencia, los datos de los búferes internos, que ya han sido procesados con otros filtros, no serán reprocesados a través del nuevo filtro en ese momento. Este comportamiento difiere de aquél de stream_filter_append().

Vea también stream_filter_register(), y stream_filter_append().

Hosting by: hurra.com
Generated: 2007-01-26 18:01:07