mb_regex_set_options

マルチバイト正規表現関数のデフォルトオプションを取得または設定する

説明

string mb_regex_set_options(stringnull $options = null)

options で表されるオプションを、 マルチバイト対応の正規表現関数のデフォルトに設定します。

パラメータ

options

設定するオプション。文字列で設定し、各文字がオプションを表します。 モードを設定する際には、モード文字は最後に指定しなければなりません。 オプションは複数指定できますが、モードはひとつしか指定できません。

Regex のオプション
オプション 意味 変更履歴
i 曖昧なマッチをオンにする  
x 拡張パターン形式を有効にする  
m '.' が改行にマッチする  
s '^' -> '\A', '$' -> '\Z'  
p ms を両方指定するのと同じ  
l 最も長くマッチするものを探す  
n 空のマッチを無視する  
e 結果のコードを eval する PHP 7.1.0 で非推奨になり、PHP 8.0.0 で削除されました。

注意:

mb_regex_set_options"e" オプションを設定しても、何も起きません。 mb_ereg_replacemb_eregi_replace で指定するようにしてください。

Regex 構文モード(ひとつだけ設定可能です)
モード 意味
j Java (Sun java.util.regex)
u GNU regex
g grep
c Emacs
r Ruby
z Perl
b POSIX Basic regex
d POSIX Extended regex

戻り値

以前設定されていたオプションを返します。 options が省略された場合、または null の場合、 現在設定されているオプションを文字列で返します。

変更履歴

バージョン 説明
8.0.0 options が指定され、null でない場合、 以前に 設定されていたオプションが返されるようになりました。 これより前のバージョンでは、 現在 設定されているオプションが返されていました。
8.0.0 options は、nullable になりました。
8.0.0 "e" オプションを指定すると、ValueError がスローされるようになりました。
7.1.0 "e" オプションを指定すると、E_DEPRECATED が発生するようになりました。

参考

  • mb_split
  • mb_ereg
  • mb_eregi