preg_grep
(PHP 4, PHP 5)
preg_grep — Retorna as entradas do array que combinaram com o padrão
Descrição
array preg_grep
( string $pattern
, array $input
[, int $flags
] )
Retorna o array consistindo dos elementos do array de input que combinaram com o dado pattern .
Parâmetros
- pattern
-
A string do padrão.
- input
-
O array de entrada.
- flags
-
Se usado PREG_GREP_INVERT, esta função retorna os elementos do array de entrada que não casam com o dado pattern .
Valor Retornado
Retorna um array indexado usando a chave do array de input .
Histórico
| Versão | Descrição |
|---|---|
| 4.2.0 | O parâmetro flags foi adicionado. |
| 4.0.4 |
Antes desta versão, o array retornado era indexado diferente das chaves do array de input . Se você quer reproduzir o antigo comportamento, use array_values() no array retornado para reindexar os valores. |
Exemplos
Example#1 Exemplo da preg_grep()
<?php
// retorna todos os elementos do array
// contendo números de ponto flutuante
$fl_array = preg_grep("/^(\d+)?\.\d+$/", $array);
?>