preg_filter

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

preg_filter — Recherche et remplace avec une expression rationnelle

Description

preg_filter() est identique à preg_replace() , mais elle ne fait que retourner les occurrences trouvées (éventuellement transformées). Pour plus de détails sur le fonctionnement de cette fonction, voir preg_replace() .

Liste de paramètres

Les paramètres sont décrits dans la documentation de preg_replace() .

Valeurs de retour

Retourne un tableau si le paramètre subject est de type tableau ou une chaîne de caractères autrement.

Si aucune occurrence n'est trouvée ou si une erreur survient, un tableau vide est retourné lorsque le paramètre subject est un tableau ou null sinon.

Erreurs / Exceptions

Si le masque regex passé ne compile pas à une regex valide, une E_WARNING est émise.

Exemples

<?php
$subject = array('1', 'a', '2', 'b', '3', 'A', 'B', '4'); 
$pattern = array('/\d/', '/[a-z]/', '/[1a]/'); 
$replace = array('A:0ドル', 'B:0ドル', 'C:0ドル'); 
echo "preg_filter renvoie\n";
print_r(preg_filter($pattern, $replace, $subject)); 
echo "preg_replace renvoie\n";
print_r(preg_replace($pattern, $replace, $subject)); 
?>

preg_filter renvoie
Array
(
 [0] => A:C:1
 [1] => B:C:a
 [2] => A:2
 [3] => B:b
 [4] => A:3
 [7] => A:4
)
preg_replace renvoie
Array
(
 [0] => A:C:1
 [1] => B:C:a
 [2] => A:2
 [3] => B:b
 [4] => A:3
 [5] => A
 [6] => B
 [7] => A:4
)

Voir aussi

• Les Masques PCRE
• preg_quote() - Protection des caractères spéciaux des expressions régulières
• preg_replace() - Rechercher et remplacer par expression rationnelle standard
• preg_replace_callback() - Rechercher et remplacer par expression rationnelle standard en utilisant une fonction de callback
• preg_grep() - Retourne un tableau avec les résultats de la recherche
• preg_last_error() - Retourne le code erreur de la dernière expression PCRE exécutée