# preg_grep

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

preg_grep — Retourne un tableau avec les résultats de la recherche

### Description

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

preg_grep() retourne un tableau qui contient les éléments de `array` qui satisfont le masque `pattern`.

### Liste de paramètres

`pattern`

  Le motif à chercher, sous la forme d'une chaîne de caractères.

`array`

  Le tableau d'entrée.

`flags`

  Si cette option vaut `PREG_GREP_INVERT`, cette fonction retourne les éléments du tableau `input` qui ne correspondent pas au motif `pattern`.

### Valeurs de retour

Retourne un tableau indexé, en utilisant les clés du tableau `array` d'entrée, ou `false` si une erreur survient.

### Erreurs / Exceptions

Si le masque regex passé ne compile pas à une regex valide, une `E_WARNING` est émise.

### Exemples

Exemple #1 Exemple avec preg_grep()

`<?php
$array = [ "4", M_PI, "2.74", 42 ];
// retourne tous les éléments du tableau contenant des nombres à virgule flottante
$fl_array = preg_grep("/^(\d+)?\.\d+$/", $array);
var_dump($fl_array);
?>`

### Voir aussi

- Les Patterns PCRE
- preg_quote() - Protection des caractères spéciaux des expressions régulières
- preg_match_all() - Expression rationnelle globale
- preg_filter() - Recherche et remplace avec une expression rationnelle
- preg_last_error() - Retourne le code erreur de la dernière expression PCRE exécutée