Retorna entradas de array que correspondem à expressão regular

# preg_grep

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

preg_grep — Retorna entradas de array que correspondem à expressão regular

### Descrição

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

Retorna o array consistindo dos elementos do parâmetro `array` que correspondem à expressão regular informada em `pattern`.

### Parâmetros

`pattern`

  A expressão a ser pesquisada, como uma string.

`array`

  O array de entrada.

`flags`

  Se definido para `PREG_GREP_INVERT`, esta função retornará os elementos do array de entrada que não correspondem ao `pattern` informado.

### Valor Retornado

Retorna um array indexado usando as chaves do parâmetro `array`, ou `false` em caso de falha.

### Erros/Exceções

Se o padrão de expressão regular passado não for compilado para uma expressão regular válida, um `E_WARNING` será emitido.

### Exemplos

Exemplo #1 Exemplo de preg_grep()

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

    // retorna todos os elementos do array contendo número em ponto flutuante
    $fl_array = preg_grep("/^(\d+)?\.\d+$/", $array);

    var_dump($fl_array);
    ?>

### Veja Também

- Expressões regulares PCRE
- preg_quote() - Escapa caracteres de expressão regular
- preg_match_all() - Realiza uma correspondência global de expressão regular
- preg_filter() - Executa pesquisa e substituição usando expressões regulares
- preg_last_error() - Retorna o código de erro da última expressão regular PCRE executada

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