mb_ereg_replace

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

説明

stringfalsenull mb_ereg_replace(
    string $pattern,
    string $replacement,
    string $string,
    stringnull $options = 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 修飾子が非推奨になりました。

注意

注意:

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

警告

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

参考

  • mb_regex_encoding
  • mb_eregi_replace