PCRE-Funktionen
PHP Manual

preg_filter

(PHP 5 >= 5.3.0)

preg_filterSucht 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() nur Übereinstimmungen 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 Übereinstimmungen gefunden wurden, wird die neue Zeichenkette subject zurückgegeben, andernfalls wird subject unverändert zurückgegeben oder NULL, falls ein Fehler auftrat.

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-Funktionen
PHP Manual