preg_grep

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

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

Descrição

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

Example #1 Exemplo de preg_grep()

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

Veja Também