Edit Report a Bug

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

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

    add a note add a note

    User Contributed Notes 4 notes

    up
    76
    Daniel Klein
    11 years ago
    A shorter way to run a match on the array's keys rather than the values:

    <?php
    function preg_grep_keys($pattern, $input, $flags = 0) {
        return     array_intersect_key($input, array_flip(preg_grep($pattern, array_keys($input), $flags)));
    }
    ?>
    up
    32
    keithbluhm at gmail dot com
    14 years ago
    Run a match on the array's keys rather than the values:

    <?php

    function preg_grep_keys( $pattern, $input, $flags = 0 )
    {
            $keys = preg_grep( $pattern, array_keys( $input ), $flags );
            $vals = array();
        foreach (     $keys as $key )
        {
                $vals[$key] = $input[$key];
        }
        return     $vals;
    }

    ?>
    up
    9
    amolocaleb at gmail dot com
    6 years ago
    This may be obvious to most experienced developers,but just in case its not,when using preg_grep to check for whitelisted items ,one must be very careful to explicitly define the regex boundaries or it will fail
    <?php
    $whitelist     = ["home","dashboard","profile","group"];
    $possibleUserInputs = ["homd","hom","ashboard","settings","group"];
    foreach(    $possibleUserInputs as  $input)
    {
         if(    preg_grep("/$input/i",$whitelist)
        {
             echo     $input." whitelisted";
        }else{
             echo     $input." flawed";
        }

    }
    ?>
    This results in:

    homd flawed
    hom whitelisted
    ashboard whitelisted
    settings flawed
    group whitelisted

    I think this is because if boundaries are not explicitly defined,preg_grep looks for any instance of  the substring in the whole array and returns true if found.This is not what we want,so boundaries must be defined.

    <?php
    foreach($possibleUserInputs as  $input)
    {
         if(    preg_grep("/^$input$/i",$whitelist)
        {
             echo     $input." whitelisted";
        }else{
             echo     $input." flawed";
        }

    }
    ?>
    this results in:
    homd flawed
    hom flawed
    ashboard flawed
    settings flawed
    group whitelisted
    in_array() will also give the latter results but will require few tweaks if say,the search is to be case insensitive,which is always the case 70% of the time
    up
    -27
    Timo Klemm
    7 years ago
    An even shorter way to run a match on the array's keys rather than the values:

    <?php
    function preg_grep_keys($pattern, $input, $flags = 0) {
        return     array_flip( preg_grep($pattern, array_flip($input), $flags ) );
    }
    ?>
    add a note add a note
    To Top