PHP preg_filter() 関数
preg_filterこの関数は正規表現による検索と置換を実行します。
構文
mixed preg_filter ( mixed $pattern , mixed $replacement , mixed $subject [, int $limit = -1 [, int &$count ]] )
preg_filter() は次と同等です:preg_replace() ただし、一致した結果のみを返します。
パラメータの説明:
- $pattern: 検索するパターン。文字列または文字列の配列を指定できます。
- $replacement: 置換に使用する文字列または文字列の配列。
- $subject: 検索と置換を実行する文字列または文字列の配列。
- $limit: オプション。各パターンを各subjectで置換する最大回数。デフォルトは -1(無制限) です。
- $count: オプション。完了した置換の回数。
例
preg_filter() と preg_replace() を比較する例
$subject = array('1', 'a', '2', 'b', '3', 'A', 'B', '4');
$pattern = array('/\d/', '/[a-z]/', '/[1a]/');
$replace = array('A:$0', 'B:$0', 'C:$0');
echo "preg_filter の戻り値:\n";
print_r(preg_filter($pattern, $replace, $subject));
echo "preg_replace の戻り値:\n";
print_r(preg_replace($pattern, $replace, $subject));
実行結果は次のとおりです:
preg_filter 返回值:
Array
(
[0] => A:C:1
[1] => B:C:a
[2] => A:2
[3] => B:b
[4] => A:3
[7] => A:4
)
preg_replace 返回值:
Array
(
[0] => A:C:1
[1] => B:C:a
[2] => A:2
[3] => B:b
[4] => A:3
[5] => A
[6] => B
[7] => A:4
)
preg_filter は一致した結果のみを返し、一致しないものは直接無視されるのに対し、preg_replace は一致しない 'A' 'B' 要素も一緒に返すことがわかります。
その他の拡張機能
PHP 正規表現(PCRE)