指定したマルチバイト文字列が正規表現に一致する部分の位置と長さを返す

# mb_ereg_search_pos

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

mb_ereg_search_pos — 指定したマルチバイト文字列が正規表現に一致する部分の位置と長さを返す

### 説明

function mb_ereg_search_pos(?string `$pattern` = `null`, ?string `$options` = `null`): array|false

マルチバイト文字列の中で正規表現に一致した部分の位置と長さを配列で返します。

検索対象の文字列は、mb_ereg_search_init() により設定します。省略した場合は、前回のものが利用されます。

### パラメータ

`pattern`

  検索パターン。

`options`

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

### 戻り値

ふたつの要素からなる配列を返します。最初の要素はオフセットをバイト単位で表したもので、 マッチしたのが検索文字列の先頭から何バイト目かを示します。 二番目の要素はマッチした部分の長さをバイト単位で表したものです。

エラーが発生した場合は `false` を返します。

### 変更履歴

バージョン | 説明
--- | ---
8.0.0 | `pattern` と `options` は、nullable になりました。

### 注意

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

### 参考

- mb_regex_encoding() - 現在のマルチバイト正規表現用のエンコーディングを取得または設定する
- mb_ereg_search_init() - マルチバイト正規表現検索用の文字列と正規表現を設定する

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