preg_grep

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

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

Описание

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);
?>

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