マルチバイト対応の正規表現マッチ

# mb_ereg

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

mb_ereg — マルチバイト対応の正規表現マッチ

### 説明

function mb_ereg(string `$pattern`, string `$string`, array `&$matches` = `null`): bool

マルチバイト対応の正規表現マッチを行います。

### パラメータ

`pattern`

  検索パターン。

`string`

  検索する 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` を空のarrayとするようになりました。 これより前のバージョンでは `matches` を変更しませんでした。

### 注意

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

### 参考

- mb_regex_encoding() - 現在のマルチバイト正規表現用のエンコーディングを取得または設定する
- mb_eregi() - マルチバイトをサポートし、大文字小文字を無視した正規表現マッチ

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open