preg_grep
(PHP 4, PHP 5, PHP 7, PHP 8)
preg_grep — Liefert Array-Elemente, die auf ein Suchmuster passen
Beschreibung
$pattern, array $array, int $flags = 0): array|false
Gibt ein Array zurück, das aus den Elementen des Arrays
array besteht, die auf das angegebene Suchmuster
pattern passen.
Parameter-Liste
-
pattern -
Der Ausdruck, nach dem gesucht werden soll, als Zeichenkette
-
array -
Das Eingabe-Array
-
flags -
Falls auf
PREG_GREP_INVERTgesetzt, gibt die Funktion die Elemente des Eingabe-Arrays zurück, die nicht auf das angegebene Suchmusterpatternpassen.
Rückgabewerte
Gibt ein Array zurück, das mit den Schlüsseln des Arrays
array indiziert ist. Bei einem Fehler wird false zurückgegeben.
Fehler/Exceptions
Wenn das übergebene Regex-Muster nicht zu einem gültigen Regex kompiliert werden
kann, wird ein Fehler der Stufe E_WARNING ausgegeben.
Beispiele
Beispiel #1 preg_grep()-Beispiel
<?php
// gibt alle Array-Elemente zurück,
// die Gleitkommazahlen enthalten
$fl_array = preg_grep("/^(\d+)?\.\d+$/", $array);
?>
Siehe auch
- PCRE-Suchmuster
- preg_quote() - Maskiert Zeichen regulärer Ausdrücke
- preg_match_all() - Führt eine vollständige Suche mit einem regulären Ausdruck durch
- preg_filter() - Sucht und ersetzt mit regulären Ausdrücken
- preg_last_error() - Liefert den Fehlercode der letzten PCRE-RegEx-Auswertung
