Fonctions PCRE
preg_grep
Fonctions PCRE
PHP Manual

# 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. Pour plus de détails sur le fonctionnement de cette fonction, voyez preg_replace().

### Liste de paramètres

`pattern`

`replacement`

`subject`

`limit`

`count`

### Valeurs de retour

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

Si des occurrences sont trouvées, le nouveau `subject` sera retourné, et sinon, `subject` sera retourné inchangé, ou `NULL` si une erreur est survenue.

### 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

- 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_match() - Expression rationnelle standard
- preg_split() - Éclate une chaîne par expression rationnelle

Fonctions PCRE
preg_grep
Fonctions PCRE
PHP Manual