preg_replace
(PHP 4, PHP 5, PHP 7)
preg_replace — 正規表現検索および置換を行う
説明
preg_replace
( string|array $pattern
, string|array $replacement
, string|array $subject
[, int $limit = -1
[, int &$count = null
]] ) : string|array|null
subject に関して
pattern を用いて検索を行い、
replacement に置換します。
パラメータ
pattern検索を行うパターン。文字列もしくは配列とすることができます。
PCRE 修飾子 も使えます。
replacement置換を行う文字列もしくは文字列の配列。 この引数が文字列で、
pattern引数が配列の場合、 すべてのパターンがこの文字列に置換されます。patternおよびreplacementのいずれもが配列の場合、各patternは 対応するreplacementに置換されます。 もし、replacement配列の要素の数がpattern配列よりも少ない場合は、余ったpatternは 空文字に置換されます。replacementでは、\n形式または$n形式で参照を指定することができます。 後者の形式の方が好ましい形式です。各参照は、n 番目のキャプチャ用サブパターンにマッチしたテキストにより置換されます。 n は 0 から 99 までとすることができ、\0または$0は パターン全体にマッチするテキストを参照します。キャプチャ用サブパターンの番号 については、その左括弧が左から右に（1から）カウントされます。 string に含まれるバックスラッシュリテラルは、エスケープが必須であることに注意して下さい。後方参照の直後に他の数字が続くような置換 (replacement) パターンを 使用する場合（すなわち、マッチしたパターンの直後に数字リテラルを置く 場合）、後方参照を行うために通常の
\1表記を 使用することができません。例えば、\11は、 後方参照\1の後にリテラル1が続くのか、後方参照\11で その後には何も続かないのかが不明のため、 preg_replace() を混乱させる可能性があります。 この場合、解決策は、${1}1を使用することです。 こうすることで、1はリテラルとなり、後方参照$1を明確に作成できます。非推奨の
e修飾子を使用する際に、 この関数は後方参照を置換する文字列のうちの特定の文字 (具体的には'、"、\および NULL) をエスケープします。 これは、後方参照をシングルクォートやダブルクォートを共用した場合 (たとえば'strlen(\'$1\')+strlen("$2")') に構文エラーが発生しないようにするためのものです。 PHP の 文字列構文 を意識し、 文字列がどのように解釈されるのかを正確に知っておくようにしましょう。subject検索・置換対象となる文字列もしくは文字列の配列
subjectが配列の場合、検索と置換はsubjectの各要素に対して行われ、返り値も配列となります。limitsubject文字列において、各パターンによる 置換を行う最大回数。デフォルトは-1(制限無し)。countこの引数が指定されると、置換回数が渡されます。
返り値
preg_replace() は、
subject 引数が配列の場合は配列を、
その他の場合は文字列を返します。
パターンがマッチした場合、〔置換が行われた〕新しい subject
を返します。マッチしなかった場合、subject
をそのまま返します。エラーが発生した場合、null を返します。
エラー / 例外
PHP 5.5.0 以降で "\e" 修飾子を使うと、
E_DEPRECATED レベルのエラーが発生します。
PHP 7.0.0 以降で "\e" 修飾子を使うと、
E_WARNING レベルのエラーが発生します。
例
例1 数字リテラルが後に続く後方参照
<?php$string = 'April 15, 2003';$pattern = '/(\w+) (\d+), (\d+)/i';$replacement = '${1}1,$3';echo preg_replace($pattern, $replacement, $string);?>
上の例の出力は以下となります。
April1,2003
例2 添字配列の使用
<?php$string = 'The quick brown fox jumps over the lazy dog.';$patterns = array();$patterns[0] = '/quick/';$patterns[1] = '/brown/';$patterns[2] = '/fox/';$replacements = array();$replacements[2] = 'bear';$replacements[1] = 'black';$replacements[0] = 'slow';echo preg_replace($patterns, $replacements, $string);?>
上の例の出力は以下となります。
The bear black slow jumps over the lazy dog.
pattern と replacement を ksort すると、所望のものが得られます。
<?phpksort($patterns);ksort($replacements);echo preg_replace($patterns, $replacements, $string);?>
上の例の出力は以下となります。
The slow black bear jumps over the lazy dog.
例3 複数値の置換
<?php$patterns = array ('/(19|20)(\d{2})-(\d{1,2})-(\d{1,2})/', '/^\s*{(\w+)}\s*=/');$replace = array ('\3/\4/\1\2', '$\1 =');echo preg_replace($patterns, $replace, '{startDate} = 1999-5-27');?>
上の例の出力は以下となります。
$startDate = 5/27/1999
例4 空白の削除
この例は、文字列から余分な空白を取り除きます。
<?php$str = 'foo o';$str = preg_replace('/\s\s+/', ' ', $str);// This will be 'foo o' nowecho $str;?>
例5 count 引数の使用
<?php$count = 0;echo preg_replace(array('/\d/', '/\s/'), '*', 'xp 4 to', -1 , $count);echo $count; //3?>
上の例の出力は以下となります。
xp***to 3
注意
注意:
patternおよびreplacementを使用する際、配列の並び順に処理されます。添字は整数であっても、 その並びは値の小さい順になっているとは限りません。 ですから、配列の添字を使って、どのpatternが、どのreplacementに置換されるかを指定しようとする場合は、 preg_replace() をコールする前に、各配列に対し ksort() を実行しておくべきです。
参考
- PCRE のパターン
- preg_quote() - 正規表現文字をクオートする
- preg_filter() - 正規表現による検索と置換を行う
- preg_match() - 正規表現によるマッチングを行う
- preg_replace_callback() - 正規表現検索を行い、コールバック関数を使用して置換を行う
- preg_split() - 正規表現で文字列を分割する
- preg_last_error() - 直近の PCRE 正規表現処理のエラーコードを返す
