|
8.126.20 stream_filter_prepend()Attache un filtre à un flux en début de liste[ Exemples avec stream_filter_prepend ] PHP 4 >= 4.3.0, PHP 5
resource
stream_filter_prepend (
resource
stream
,
string
filtername
,
int
read_write
,
mixed
params
)
stream_filter_prepend
ajoute le filtre
filtername
à la liste de filtres attachés au
flux
stream
. Ce filtre sera ajouté avec
les paramètres spécifiés dans
params
à la
fin
de cette liste et sera donc
appelé en dernier durant les opérations de flux.
Pour ajouter un filtre à la fin de la liste, utilisez
la fonction
stream_filter_prepend
.
Par défaut,
stream_filter_prepend
va ajouter
le filtre à la liste de filtres de lecture si le fichier a été ouvert
en mode lecture (
r
et/ou
+
). Le
filtre sera aussi attaché à la liste des filtres de lecture
si le fichier a été ouvert en mode lecture (
w
,
a
et/ou
+
).
STREAM_FILTER_READ
,
STREAM_FILTER_WRITE
, et/ou
STREAM_FILTER_ALL
peuvent aussi être utilisées
dans le paramètre
read_write
pour contrôler
ce comportement. Voyez la fonction
stream_filter_append
pour un exemple de l'utilisation
de ce paramètre.
Depuis PHP 5.0.1, cette fonction retourne une ressource qui peut être utilisée
pour se référer à cette instance de filtre durant l'appel à la fonction
stream_filter_remove
.
Dans les versions antérieures à PHP 5.1.0, cette fonction retourne
FALSE
en cas de succès,
FALSE
sinon.
| Note | |
Les données du flux (locales et distantes) sont retournées en morceaux,
les données non acheminées étant conservées dans le tampon interne.
Lorsqu'un nouveau filtre est ajouté au début du flux, les données dans
le tampon interne ne sont
pas
passées dans le nouveau
filtre à ce moment là. Ceci est différent du comportement de
stream_filter_append
.
|
Voir aussi
stream_register_filter
et
stream_filter_append
.
|
