PHP 4, PHP 5, PHP 7, PHP 8
preg_grep - Return array entries that match the pattern

preg_grep( string$pattern, array$array, [int$flags = 0] ): array|false

Returns the array consisting of the elements of the array array that match the given pattern.



The pattern to search for, as a string.


The input array.


If set to PREG_GREP_INVERT, this function returns the elements of the input array that do not match the given pattern.

Return Values

Returns an array indexed using the keys from the array array, or false on failure.

Exceptions and Errors

If the regex pattern passed does not compile to a valid regex, an E_WARNING is emitted.

Related Functions

Example of preg_grep

Show all examples for preg_grep

PHP Version:

Function preg_grep:

Regular Expressions (Perl-Compatible) Functions

Most used PHP functions