mb_ereg_replace

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

mb_ereg_replace — マルチバイト文字列に正規表現による置換を行う

mb_ereg_replace(
    string $pattern,
    string $replacement,
    string $string,
    ?string $options = null
): string|false|null

string から pattern にマッチする文字列を探し、見つかった文字列を replacement で置換します。

pattern

正規表現パターン。

マルチバイト文字を pattern で使用することができます。

replacement

置換文字列。

string

調べたい文字列。

options

検索オプション。説明は、mb_regex_set_options() を参照ください。

成功した場合に結果の文字列、エラー時に false を返します。 string が現在のエンコーディングに照らして不正な場合は、null を返します。

バージョン説明

8.0.0 options は、nullable になりました。

7.1.0 この関数は、現在のエンコーディングに照らして string が正しいかをチェックするようになりました。

7.1.0 e 修飾子が非推奨になりました。

バージョン	説明
8.0.0	`options` は、nullable になりました。
7.1.0	この関数は、現在のエンコーディングに照らして `string` が正しいかをチェックするようになりました。
7.1.0	`e` 修飾子が非推奨になりました。

注意:
内部エンコーディングあるいは mb_regex_encoding() で指定した文字エンコーディングを、この関数の文字エンコーディングとして使用します。

警告

信頼できない入力に対しては、絶対に e 修正子を使用してはいけません。 (preg_replace() と同様、) 自動的なエスケープは行いません。このことを忘れていると、自分の書いたアプリケーションにリモートコード実行の脆弱性を作りこんでしまうことになります。