Last updated: Fri, 05 Sep 2008

preg_replace_callback

(PHP 4 >= 4.0.5, PHP 5)

preg_replace_callback — 正規表現検索を行い、コールバック関数を使用して置換を行う

説明

mixed preg_replace_callback ( mixed $pattern , callback $callback , mixed $subject [, int $limit [, int &$count ]] )

この関数の動作は、ほぼ preg_replace() と同じですが、 replacement の代わりに callback を指定するところが異なります。

パラメータ

pattern

検索するパターン。文字列あるいは文字列の配列のいずれかとなります。

callback

このコールバック関数は、検索対象文字列でマッチした要素の配列が指定されてコールされます。このコールバック関数は、置換後の文字列を返す必要があります。

しばしば、1カ所だけで preg_replace_callback()用の callback 関数が必要となることがあります。この場合、create_function()を使用して、 preg_replace_callback() をコールする際に使用するコールバック関数として匿名の関数を宣言することができます。このようにすることにより、コールに関するすべての情報を 1 ヶ所に集め、他の場所で使用されないコールバック関数名で関数の名前空間を汚染しないようにすることができます。

例1 preg_replace_callback() と create_function()


<?php
/* Unix 方式のコマンドラインフィルタです。
 * 段落の冒頭の大文字を、小文字に変換します。*/
$fp = fopen("php://stdin", "r") or die("標準入力から読み込めません");
while (!feof($fp)) {
    $line = fgets($fp);
    $line = preg_replace_callback(
        '|<p>\s*\w|',
        create_function(
            // ここでは単一引用符の使用が不可欠です。
            // そうでない場合は、$ をすべて \$ とエスケープします。
            '$matches',
            'return strtolower($matches[0]);'
        ),
        $line
    );
    echo $line;
}
fclose($fp);
?>

subject

文字列あるいは文字列の配列で、検索および置換の対象となる文字列を指定します。

limit

subject 文字列における各パターンの最大置換回数。デフォルトは -1 (無制限) です。

count

指定した場合は、置換を行った回数がここに格納されます。

返り値

preg_replace_callback() は、 subject が配列の場合には配列を、それ以外の場合は文字列を返します。

マッチするものが見つかった場合は新しい subject を返し、それ以外の場合はもとの subject をそのまま返します。

変更履歴

バージョン	説明
5.1.0	パラメータ `count` が追加されました。

例

例2 preg_replace_callback() の例


<?php
// このテキストは 2002 に使われていたものなのですが、
// これを 2003 年対応の日付に変更したいのです
$text = "エイプリルフールの日付は 04/01/2002 です\n";  
$text.= "この前のクリスマスの日付は 12/24/2001 でした\n";  
// コールバック関数
function next_year($matches)
{
  // 通常は、$matches[0] がマッチした全体を表します。
  // $matches[1] は、マッチした中で、パターン内の最初の '(...)'
  // にあてはまる部分を表します。それ以降も同様です。
  return $matches[1].($matches[2]+1);
}
echo preg_replace_callback(
            "|(\d{2}/\d{2}/)(\d{4})|",
            "next_year",
            $text);

?>

上の例の出力は以下となります。

エイプリルフールの日付は 04/01/2003 です
この前のクリスマスの日付は 12/24/2002 でした

例3 カプセル化された BB code を処理するための、 preg_replace_callback() での再帰構造の使用


<?php
$input = "通常の位置 [indent] 字下げ [indent] もっと字下げ [/indent] 字下げ [/indent] 通常の位置"; 

function parseTagsRecursive($input)
{

    $regex = '#\[indent]((?:[^[]|\[(?!/?indent])|(?R))+)\[/indent]#';

    if (is_array($input)) {
        $input = '<div style="margin-left: 10px">'.$input[1].'</div>';
    }

    return preg_replace_callback($regex, 'parseTagsRecursive', $input);
}

$output = parseTagsRecursive($input);

echo $output;
?>

参考

preg_replace()
create_function()
callback 型に関する情報

preg_replace

preg_quote

Last updated: Fri, 05 Sep 2008

add a note User Contributed Notes
preg_replace_callback

nene at triin dot net
20-May-2008 12:14


The first example is bad, because it creates function for every line it processes. When the file has many lines, you could easily run out of memory. The code should be changed so, that create_function() is used outside of loop.

Sjon at hortensius dot net
24-Jun-2007 01:56


preg_replace_callback returns NULL when pcre.backtrack_limit is reached; this sometimes occurs faster then you might expect. No error is raised either; so don't forget to check for NULL yourself

matt at mattsoft dot net
26-Apr-2006 11:16


it is much better on preformance and better practice to use the preg_replace_callback function instead of preg_replace with the e modifier.



function a($text){return($text);}



// 2.76 seconds to run 50000 times

preg_replace("/\{(.*?)\}/e","a('\\1','\\2','\\3',\$b)",$a);



// 0.97 seconds to run 50000 times

preg_replace_callback("/\{(.*?)\}/s","a",$a);

add a note

preg_replace

preg_quote

Last updated: Fri, 05 Sep 2008