preg_filter
(PHP 5 >= 5.3.0)
preg_filter — Recherche et remplace avec une expression rationnelle
Description
mixed preg_filter
( mixed
$pattern
, mixed $replacement
, mixed $subject
[, int $limit = -1
[, int &$count
]] )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, voyez 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 sera retourné lorsque le paramètre
subject est un tableau ou NULL sinon.
Exemples
Exemple #1 Exemple de comparaison de preg_filter() avec preg_replace()
<?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));
?>L'exemple ci-dessus va afficher :
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 Patterns PCRE
- 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
