(PHP 7, PHP 8)
preg_replace_callback_array — Éffectue une recherche de correspondance avec une expression régulière et remplace grâce à une fonction de rappel
$pattern,$subject,$limit = -1,&$count = null,$flags = 0Le comportement de cette fonction est similaire à preg_replace_callback(), à l'exception que les fonctions de rappel sont exécutéees à chaque masque.
patternUn tableau associatif qui établie une relation entre les masques (clés) et les fonctions de rappels callable (valeurs).
subjectLa chaîne de caractères ou tableau qui contient les chaîne de caractères à chercher et remplacer.
limit Le nombre maximum de remplacement pour chaque masque dans chaque chaîne de caractèressubject. Par défaut -1 (aucune limite).
countSi fournit, cette variable sera remplit avec le nombre de remplacement effectué.
flagsflags peut être une combinaison des drapeaux PREG_OFFSET_CAPTURE et PREG_UNMATCHED_AS_NULL, qui influence le format du tableau de correspondances. Voir la description de preg_match() pour plus de détail.
preg_replace_callback_array() retourne un tableau si le paramètre subject est un tableau, ou sinon une chaîne de caractères. Lors d'une erreur la valeur de retour est null.
Si des correspondances sont trouvées, le nouveau sujet sera retourné, sinon subject sera retourné inchangé.
Si le masque regex passé ne compile pas à une regex valide, une E_WARNING est émise.
| Version | Description |
|---|---|
| 7.4.0 | Le paramètre flags a été ajouté. |
Exemple #1 Exemple de preg_replace_callback_array()
<?php
$subject = 'Aaaaaa Bbb';
preg_replace_callback_array(
[
'~[a]+~i' => function ($match) {
echo strlen($match[0]), ' correspondances de "a" trouvées', PHP_EOL;
},
'~[b]+~i' => function ($match) {
echo strlen($match[0]), ' correspondances de "b" trouvées', PHP_EOL;
}
],
$subject
);
?>L'exemple ci-dessus va afficher :
6 correspondances de "a" trouvées 3 correspondances de "b" trouvées