Bloc Fonctionnel PREG_FILTER

Le bloc fonctionnel PREG_FILTER recherche et remplace avec des expressions régulières.

Remarque: Cette fonction est Binary-Safe. Cela signifie que les caractères UTF8 ne peuvent pas être traités directement.

Outre le fait que le bloc fonctionnel PREG_FILTER ne renvoie les chaînes de caractères (éventuellement converties) qu'en cas de correspondances, il est identique au bloc fonctionnel PREG_REPLACE.

Entrée PATTERN

L'expression sous forme de chaîne de caractères à rechercher. Certains modificateurs PCRE sont également disponibles.

Entrée REPLACEMENT

La chaîne de caractères pour le remplacement. Celle-ci peut contenir des références sous la forme \n ou $n, cette dernière étant préférable. Chacune de ces références est remplacée par le texte capturé par le n-ième motif de recherche encadré. n peut avoir une valeur comprise entre 0 et 99. \0 ou $0 font référence au texte qui correspond au motif de recherche complet. Pour obtenir le numéro du sous-motif de capture, les parenthèses ouvrantes sont comptées à partir de la gauche vers la droite en commençant par 1. Pour utiliser un antislash dans le remplacement, il doit être doublé "\\".

Si vous souhaitez travailler avec un remplacement dans lequel une référence rétroactive est directement suivie d'un autre nombre (c'est-à-dire qu'après la correspondance avec un motif de recherche, un nombre doit venir), vous ne pouvez pas utiliser l'écriture \1 pour votre référence rétroactive. Par exemple, \11 confondrait la fonction parce qu'elle ne sait pas si vous voulez la référence rétroactive \1 suivie du nombre 1 ou seulement la référence rétroactive \11. Dans ce cas, la solution est d'utiliser ${1}1. Cela crée une référence rétroactive isolée $1 et le 1 reste un symbole de lettre.

Si vous utilisez le modificateur obsolète e, cette fonction masque certains caractères (à savoir ', ", \ et NULL) dans les chaînes de caractères avec lesquelles les références rétroactives seront remplacées. Cela est fait pour s'assurer qu'aucun erreur de syntaxe ne se produit lorsque des références rétroactives contenant des guillemets simples ou doubles sont utilisées. Assurez-vous de connaître la syntaxe des chaînes de caractères pour savoir exactement à quoi ressemble la chaîne de caractères évaluée.

Entrée SUBJECT

L'entrée définit la chaîne de caractères à parcourir.

Entrée LIMIT

Le nombre maximal possible de remplacements pour chaque motif de recherche dans chaque sujet. Valeur par défaut : -1 ou NULL (aucune limite).

Sortie Q

Si des correspondances (éventuellement converties) ont été trouvées, la nouvelle chaîne de caractères Q est renvoyée, sinon SUBJECT est renvoyée inchangée ou NULL, en cas d'erreur.

Sortie COUNT

La sortie renvoie le nombre de remplacements effectués.