PHP preg_filter() 関数の使用法および例

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：任意、完了した置換回数。

オンラインサンプル

<?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 返り値：
配列
(
    [0] => A:C:1
    [1] => B:C:a
    [2] => A:2
    [3] => B:b
    [4] => A:3
    [7] => A:4
)
preg_replace 返り値：
配列
(
    [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)