Fonction PHP preg_replace()
Exemple
Utilisez une expression régulière insensible à la casse pour remplacer Microsoft par W3Schools dans une chaîne :
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo
preg_replace($pattern, 'W3Schools', $str);
?>
Définition et utilisation
La preg_replace() fonction renvoie une chaîne ou un tableau de chaînes où toutes les correspondances d'un modèle ou d'une liste de modèles 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 modèle sont remplacées par la chaîne de remplacement.
2. Un tableau de motifs et une chaîne de remplacement. Les correspondances avec l'un des modèles 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 des 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 modèle. Dans la chaîne renvoyée, les instances de \n et $n seront remplacées par la sous-chaîne qui correspondait au 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 modèles dans l'ordre dans lequel ils sont donnés. Le résultat de l'évaluation du premier modèle sur la chaîne est utilisé comme chaîne d'entrée pour le deuxième modèle et ainsi de suite. Cela peut entraîner un comportement inattendu.
Syntaxe
preg_replace(patterns, replacements, input, limit, count)
Valeurs des paramètres
| Parameter | Description |
|---|---|
| patterns | Required. Contains a regular expression or array of regular expressions |
| replacements | Required. A replacement string or an array of replacement strings |
| input | Required. The string or array of strings in which replacements are being performed |
| limit | Optional. Defaults to -1, meaning unlimited. Sets a limit to how many replacements can be done in each string |
| count | Optional. After the function has executed, this variable will contain a number indicating how many replacements were performed |
Détails techniques
| Valeur de retour : | Renvoie 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é |
❮ Référence PHP RegExp