array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.preg-grep.php', 1 => 'preg_grep', 2 => 'Liefert Array-Elemente, die auf ein Suchmuster passen', ), 'up' => array ( 0 => 'ref.pcre.php', 1 => 'PCRE-Funktionen', ), 'prev' => array ( 0 => 'function.preg-filter.php', 1 => 'preg_filter', ), 'next' => array ( 0 => 'function.preg-last-error.php', 1 => 'preg_last_error', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/pcre/functions/preg-grep.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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