Bloc Fonctionnel PREG_REPLACE

Le bloc fonctionnel PREG_REPLACE recherche et remplace à l'aide d'expressions régulières.

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

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 gauche à 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 chiffre (c'est-à-dire qu'après la correspondance avec un motif de recherche, un chiffre doit venir), vous ne pouvez pas utiliser l'écriture \1 pour votre référence rétroactive. Par exemple, \11 confondrait la fonction car elle ne sait pas si vous voulez la référence rétroactive \1 suivie du chiffre 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 ont été trouvées, la nouvelle chaîne de caractères Q est retournée, sinon SUBJECT est retourné inchangé ou NULL, si une erreur s'est produite.

Sortie COUNT

La sortie renvoie le nombre de remplacements effectués.