パターンにマッチする配列の要素を返す

# preg_grep

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

preg_grep — パターンにマッチする配列の要素を返す

### 説明

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

`array` 配列の要素のうち、 指定した `pattern` にマッチするものを要素とする配列を返します。

### パラメータ

`pattern`

  検索するパターンを表す文字列。

`array`

  入力の配列。

`flags`

  `PREG_GREP_INVERT` を設定すると、この関数は 与えた `pattern` にマッチ しない 要素を返します。

### 戻り値

`array` 配列のキーを使用した配列を返します。 失敗した場合に `false` を返します

### エラー / 例外

渡された正規表現のパターンがコンパイルできない場合、`E_WARNING` が発生します。

### 例

例1 preg_grep() の例

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

    // すべての浮動小数点数を含む配列要素を返す
    $fl_array = preg_grep("/^(\d+)?\.\d+$/", $array);

    var_dump($fl_array);
    ?>

### 参考

- PCRE のパターン
- preg_quote() - 正規表現文字をクオートする
- preg_match_all() - 繰り返し正規表現検索を行う
- preg_filter() - 正規表現による検索と置換を行う
- preg_last_error() - 直近の PCRE 正規表現処理のエラーコードを返す

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