Возвращает массив вхождений, которые соответствуют шаблону

# preg_grep

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

preg_grep — Возвращает массив вхождений, которые соответствуют шаблону

### Описание

function preg_grep(string `$pattern`, array `$array`, int `$flags` = 0): array|false

Возвращает массив, состоящий из элементов входящего массива `array`, которые соответствуют заданному шаблону `pattern`.

### Список параметров

`pattern`

  Искомый шаблон в виде строки.

`array`

  Входящий массив.

`flags`

  В случае, если установлен в `PREG_GREP_INVERT`, функция preg_grep() возвращает те элементы массива, которые не соответствуют заданному шаблону `pattern`.

### Возвращаемые значения

Возвращает массив, индексированный ключами из массива `array` или `false`, если возникла ошибка.

### Ошибки

Если передали шаблон регулярного выражения, который не компилируется в допустимое регулярное выражение, выдаётся ошибка уровня `E_WARNING`.

### Примеры

Пример #1 Пример использования preg_grep()

    <?php

    $array = [ "4", M_PI, "2.74", 42 ];

    // Возвращает все элементы массива, содержащие числа с плавающей точкой
    $fl_array = preg_grep("/^(\d+)?\.\d+$/", $array);

    var_dump($fl_array);
    ?>

### Смотрите также

- Регулярные выражения PCRE
- preg_quote() - Экранирует символы в регулярных выражениях
- preg_match_all() - Выполняет глобальный поиск шаблона в строке
- preg_filter() - Производит поиск и замену по регулярному выражению
- preg_last_error() - Возвращает код ошибки выполнения последнего регулярного выражения PCRE

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