(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
mb_ereg — マルチバイト対応の正規表現マッチ
$pattern, string $string, array &$matches = null): boolマルチバイト対応の正規表現マッチを行います。
pattern検索パターン。
string検索文字列。
matches
pattern 内のカッコで囲まれた部分文字列にマッチするものが
あった場合、第3引数 matches が指定されていると、
配列 matches の要素としてマッチ結果が格納されます。
マッチするものがなかった場合、matches は空の配列となります。
$matches[1] には最初の左括弧で指定された部分文字列が入ります。 $matches[2] には2番目の左括弧で指定された部分文字列が入ります。 以下同様です。 $matches[0] にはマッチした文字列全体のコピーが入ります。
string 内に pattern
にマッチする文字列があるかを返します。
| バージョン | 説明 |
|---|---|
| 8.0.0 |
この関数は、成功時に true を返すようになりました。
これより前のバージョンでは、
string 内に pattern
にマッチする文字列が存在し、かつ matches が渡された場合、
マッチした文字列のバイト長を返していました。
matches が渡されなかった場合、
あるいはマッチした文字列の長さが 0 だった場合、
この関数は 1 を返していました。
|
| 7.1.0 |
マッチしなかった場合、mb_ereg() は
matches を空の配列とするようになりました。
これより前のバージョンでは matches を変更しませんでした。
|
注意:
内部エンコーディングあるいは mb_regex_encoding() で指定した文字エンコーディングを、 この関数の文字エンコーディングとして使用します。