PCRE-Funktionen
preg_grep
PCRE-Funktionen
PHP Manual

# preg_filter

(PHP 5 >= 5.3.0)

preg_filter — Sucht und ersetzt mit regulären Ausdrücken

### Beschreibung

mixed preg_filter ( mixed `$pattern` , mixed `$replacement` , mixed `$subject` [, int `$limit` = -1 [, int `&$count` ]] )

Davon abgesehen, dass preg_filter() bei Übereinstimmungen nur (möglicherweise umgewandelte) Zeichenketten zurückgibt, ist sie mit preg_replace() identisch. Details über die Funktionsweise dieser Funktion finden Sie in der preg_replace()-Dokumentation.

### Rückgabewerte

Gibt ein Array zurück, falls `subject` ein Array ist, andernfalls eine Zeichenkette.

Falls keine Übereinstimmungen gefunden wurden oder ein Fehler auftrat, wird ein leeres Array zurückgegeben, wenn `subject` ein Array ist, andernfalls `NULL`.

### Beispiele

Beispiel #1 Beispiel zum Vergleich von preg_filter() und preg_replace()

`<?php
$zeichenkette = array('1', 'a', '2', 'b', '3', 'A', 'B', '4');
$suchmuster = array('/\d/', '/[a-z]/', '/[1a]/');
$ersatz = array('A:$0', 'B:$0', 'C:$0');
echo "preg_filter liefert\n";
print_r(preg_filter($suchmuster, $ersatz, $zeichenkette));
echo "preg_replace liefert\n";
print_r(preg_replace($suchmuster, $ersatz, $zeichenkette));
?>`

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    preg_filter liefert
    Array
    (
        [0] => A:C:1
        [1] => B:C:a
        [2] => A:2
        [3] => B:b
        [4] => A:3
        [7] => A:4
    )
    preg_replace liefert
    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
    )

### Siehe auch

- PCRE-Suchmuster
- preg_replace() - Sucht und ersetzt mit regulären Ausdrücken
- preg_replace_callback() - Sucht und ersetzt einen regulären Ausdruck unter Verwendung eines Callbacks
- preg_grep() - Liefert Array-Elemente, die auf ein Suchmuster passen
- preg_last_error() - Liefert den Fehlercode der letzten PCRE RegEx-Auswertung

PCRE-Funktionen
preg_grep
PCRE-Funktionen
PHP Manual