ereg_replace

(PHP 3, PHP 4 >= 4.0.0)

ereg_replace -- 正規表現による置換

説明

string ereg_replace (string pattern, string replacement, string string)

この関数は、stringをスキャンして patternにマッチするものを探し、 マッチしたテキストをreplacement で置換します。

置換後の文字列が返されます。(マッチしなかった場合は、 元の文字列が返されます。)

patternの中に括弧でくくられた部分 文字列が含まれている場合、replacement の中に\\数字 のような部分文字列を埋め込むこともできます。この部分は、 「数字」番目の括弧でくくられた部分文字列にマッチする文字列 に置き換えられます。また、\\0は文字列全体 を指します。9個までの部分文字列を使うことができます。括弧は 入れ子になっていても構いません。この場合は開き括弧 '(' が 最大9個まで使用可能です。

stringにおいてマッチするものがなかった 場合、stringは変更されずに返されます。

たとえば、以下のサンプルコードは"This was a test" と3回表示します。

例 1ereg_replace()の例


$string = "This is a test";
echo ereg_replace ( " is", " was", $string );
echo ereg_replace ( "( )is", "\\1was", $string );
echo ereg_replace ( "(( )is)", "\\2was", $string );
      

注意しなければならないのは、パラメータ replacement として整数値を使用する場合、 期待する結果が得られない可能性があります。これは、 ereg_replace() が文字の値を数値として解釈し、 使用するためです。例えば、次のようになります。

例 2ereg_replace() の例


<?php
/* これは期待した通りに動作しません。 */
$num = 4;
$string = "This string has four words.";
$string = ereg_replace('four', $num, $string);
echo $string;   /* 出力: 'This string has   words.' */

/* これは動作します。 */
$num = '4';
$string = "This string has four words.";
$string = ereg_replace('four', $num, $string);
echo $string;   /* 出力: 'This string has 4 words.' */
?>
      

ereg(), eregi(), eregi_replace()も参照下さい。