PHP preg_replace()関数
例
大文字と小文字を区別しない正規表現を使用して、文字列内でMicrosoftをW3Schoolsに置き換えます。
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo
preg_replace($pattern, 'W3Schools', $str);
?>
定義と使用法
このpreg_replace()
関数は、入力で見つかったパターンまたはパターンのリストのすべての一致がサブ文字列に置き換えられた文字列または文字列の配列を返します。
この関数を使用するには、次の3つの方法があります。
1.1つのパターンと置換文字列。パターンの一致は、置換文字列に置き換えられます。
2.パターンの配列と置換文字列。いずれかのパターンに一致すると、置換文字列に置き換えられます。
3.パターンの配列と置換文字列の配列。各パターンの一致は、replacements配列の同じ位置にある置換文字列に置き換えられます。その位置にアイテムが見つからない場合、一致は空の文字列に置き換えられます。
置換文字列には、\ nまたは$ nの形式の後方参照が含まれる場合があります。nはパターン内のグループのインデックスです。返される文字列では、\ nと$ nのインスタンスは、グループによって一致したサブ文字列に置き換えられます。\ 0または$ 0が使用されている場合は、式全体に置き換えられます。
注:関数は、入力文字列ごとに、指定された順序でパターンを評価します。文字列の最初のパターンを評価した結果は、2番目のパターンの入力文字列として使用されます。これにより、予期しない動作が発生する可能性があります。
構文
preg_replace(patterns, replacements, input, limit, count)
パラメータ値
Parameter | Description |
---|---|
patterns | Required. Contains a regular expression or array of regular expressions |
replacements | Required. A replacement string or an array of replacement strings |
input | Required. The string or array of strings in which replacements are being performed |
limit | Optional. Defaults to -1, meaning unlimited. Sets a limit to how many replacements can be done in each string |
count | Optional. After the function has executed, this variable will contain a number indicating how many replacements were performed |
技術的な詳細
戻り値: | 入力文字列に置換を適用した結果の文字列または文字列の配列を返します |
---|---|
PHPバージョン: | 4.0.5+ |
変更ログ: | PHP5.1.0-カウントパラメータが追加されました |
❮PHPRegExpリファレンス