Descripción
bool
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.
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().
