トップページ　→関数リファレンス　→自然言語および文字エンコーディング　→マルチバイト文字列　→マルチバイト文字列関数

関数・クラス解説

mb_ereg

version:PHP 4 >= 4.2.0, PHP 5, PHP 7 (公式)

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

公式リファレンス

書式

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 を返します。

注意

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

更新履歴

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