PHP preg_filter() 関数

PHP 正则表达式(PCRE)PHP 正規表現(PCRE)

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() を比較する例

<?php $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)PHP 正規表現(PCRE)

その他の拡張機能