preg_grep

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

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

説明

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

参考

関連キーワード: 　配列, パターン, 要素, preg, マッチ, array, pattern, PCRE, 検索, 関数