# preg_grep

(PHP 4, PHP 5, PHP 7, PHP 8)

preg_grep — Liefert Array-Elemente, die auf ein Suchmuster passen

### Beschreibung

preg_grep(string `$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_INVERT` gesetzt, gibt die Funktion die Elemente des Eingabe-Arrays zurück, die nicht auf das angegebene Suchmuster `pattern` passen.

### 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
$array = [ "4", M_PI, "2.74", 42 ];
// Alle Array-Elemente zurückgeben, die Gleitkommazahlen enthalten
$fl_array = preg_grep("/^(\d+)?\.\d+$/", $array);
var_dump($fl_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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open