mb_ereg

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

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

mb_ereg ( string $pattern , string $string [, array &$regs ] ) : int

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

pattern

検索パターン。

string

検索文字列。

regs

pattern 内のカッコで囲まれた部分文字列にマッチするものがあった場合、第3引数 regs が指定されていると、配列 regs の要素としてマッチ結果が格納されます。マッチするものがなかった場合、regs は空の配列となります。

$regs[1] には最初の左括弧で指定された部分文字列が入ります。 $regs[2] には2番目の左括弧で指定された部分文字列が入ります。以下同様です。 $regs[0] にはマッチした文字列全体のコピーが入ります。

string 内に pattern にマッチする文字列があったらマッチした文字列のバイト長を返し、マッチしなかった場合やエラーが起こった場合は FALSE を返します。

オプションのパラメータ regs が渡されなかった場合、あるいはマッチした文字列の長さが 0 だった場合、この関数は 1 を返します。

バージョン	説明
7.1.0	マッチしなかった場合、mb_ereg() は `regs` を空の配列とするようになりました。以前は `regs` を変更しませんでした。

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