preg_grep

(Auszug aus "Reguläre Ausdrücke" von Jeffrey E. F. Friedl)

preg_grep(pattern, input [, flags ])

Parameter

pattern

Der Pattern-Parameter: eine Regex mit Begrenzungszeichen, mit optionalen Modifikatoren.

input

Ein Array, dessen Werte in das Rückgabe-Array kopiert werden, sofern sie auf den pattern passen.

flags

Das optionale Flag PREG_GREP_INVERT.

Rückgabewert

Ein Array mit den Werten aus input, die auf die Regex pattern passen (oder, bei Benutzung der Option PREG_GREP_INVERT, die nicht auf die Regex passen).

Erläuterungen

Mit preg_grep wählt man Werte aus einem Array und erzeugt daraus ein neues Array, das nur die Werte enthält, auf die die Regex passt (oder, mit PREG_GREP_INVERT, auf die sie nicht passt). Das ursprüngliche Array bleibt unberührt.

Das folgende einfache Beispiel

filtert aus $input diejenigen Elemente heraus, die Whitespace enthalten. Die Umkehrung ist:

Hier werden die Elemente herausgesucht, die keinen Whitespace enthalten. Beachten Sie, dass das etwas anderes ist als:

Hier werden Array-Elemente mit leeren Werten (mit Länge null) nicht mitkopiert.