subject
に関して
pattern
を用いて検索を行い、
replacement
に置換します。
limit
を指定した場合、
limit
回のマッチまで置換が行なわれます。
limit
が 省略されるか -1 の場合、マッチするものは全て置換されます。
replacement
では、
\\
n
形式または (PHP 4.0.4 以降)
$n
形式で参照を指定することができます。後者の形式の方が好ましい形式 です。各参照は、
n
番目の括弧で括られた パターンにマッチしたテキストにより置換されます。
n
は0から99までとすることができ、
\\0
または
$0
はパターン全 体にマッチするテキストを参照します。マッチしたサブパターンの番号
を得るために左括弧は(1から始まって)左から右に番号がふられます。
マッチした場合、新しい
subject
が返されます。 マッチしなかった場合には、
subject
は、無変 更で返されます。
preg_replace()
に渡す全てのパラメータは配列とする ことができます。
subject
が配列の場合、検索及び置換は
subject
の各エントリ毎に行われ、 返り値も配列として返されます。
pattern
および
replacement
が配列の場合、
preg_replace()
は各配列からの値を用いて
subject
に関する検索および置換を行います。
replacement
の値が
pattern
よりも少ない場合、残りの置換用文字列 に関して空の文字列が使用されます。 パターン
pattern
が配列で
replacement
が文字列の場合、この置換文字列 は
pattern
の各値毎に使用されます。 しかし、逆の場合は意味がありません。
/e
修飾子は、
preg_replace()
が
replacement
パラメータを適当な置換を 行った後、PHP コードとして処理するようにします。 ヒント:
replacement
が有効なPHPコード文字列から 構成されるようにしてください。そうでない場合、
preg_replace()
のある行でPHP は構文エラーを発 生します。
$startDate = 5/27/1999 |
注意 パラメータ limit はPHP 4.0.1pl2で追加されま した。
preg_match()
,
preg_match_all()
,
preg_split()
も参照下さい。