PHP preg_replace() Fonction
Exemple
Utilisez une expression régulière insensible à la casse pour remplacer "Microsoft" par "formation-ti.org" dans une chaîne :
<?php
$str = 'Visitez Microsoft!';
$pattern = '/microsoft/i';
echo preg_replace($pattern, 'formation-ti.org', $str);
?> Définition et Utilisation
La preg_replace() fonction retourne une chaîne ou un tableau de chaînes où toutes les correspondances d'un motif ou d'une liste de motifs trouvés dans l'entrée sont remplacées par des sous-chaînes.
Il existe trois manières différentes d'utiliser cette fonction :
1. Un motif et une chaîne de remplacement. Les correspondances du motif sont remplacées par la chaîne de remplacement.
2. Un tableau de motifs et une chaîne de remplacement. Les correspondances de l'un des motifs sont remplacées par la chaîne de remplacement.
3. Un tableau de motifs et un tableau de chaînes de remplacement. Les correspondances de chaque motif sont remplacées par la chaîne de remplacement à la même position dans le tableau de remplacements. Si aucun élément n'est trouvé à cette position, la correspondance est remplacée par une chaîne vide.
Les chaînes de remplacement peuvent contenir une référence arrière sous la forme \n ou $n où n est l'index d'un groupe dans le motif. Dans la chaîne retournée, les instances de \n et $n seront remplacées par la sous-chaîne qui a été correspondue par le groupe ou, si \0 ou $0 sont utilisés, par l'expression entière.
Remarque : Pour chaque chaîne d'entrée, la fonction évalue les motifs dans l'ordre dans lequel ils sont donnés. Le résultat de l'évaluation du premier motif sur la chaîne est utilisé comme chaîne d'entrée pour le deuxième motif, et ainsi de suite. Cela peut conduire à un comportement inattendu.
Syntaxe
preg_replace( motifs, remplacements, entrée, limite, compte ) Valeurs des Paramètres
| Paramètre | Description |
|---|---|
| motifs | Requis. Contient une expression régulière ou un tableau d'expressions régulières |
| remplacements | Requis. Une chaîne de remplacement ou un tableau de chaînes de remplacement |
| entrée | Requis. La chaîne ou le tableau de chaînes dans lequel les remplacements sont effectués |
| limite | Optionnel. Par défaut à -1, ce qui signifie illimité. Définit une limite sur le nombre de remplacements pouvant être effectués dans chaque chaîne |
| compte | Optionnel. Après l'exécution de la fonction, cette variable contiendra un nombre indiquant combien de remplacements ont été effectués |
Détails Techniques
| Valeur de Retour : | Retourne une chaîne ou un tableau de chaînes résultant de l'application des remplacements à la chaîne ou aux chaînes d'entrée |
|---|---|
| Version PHP : | 4.0.5+ |
| Journal des Modifications : | PHP 5.1.0 - Le paramètre count a été ajouté |