PHP マニュアル: マルチバイトをサポートし、大文字小文字を無視した正規表現マッチ

説明

bool mb_eregi(string $pattern, string $string, array &$matches = null)

マルチバイトをサポートし、かつ大文字小文字を無視した正規表現マッチを実行します。

パラメータ

pattern

正規表現のパターン

string

検索対象の string

matches

pattern の括弧で囲まれた部分文字列にマッチする部分が見つかり、かつ3番目の引数 matches が渡された場合、マッチした部分が matches 配列に格納されます。何もマッチしなかった場合、 matches には空の配列が設定されます。

$matches[1] には、最初の左括弧から始まる部分文字列が含まれます。 $matches[2] には、二番目の左括弧から始まる部分文字列が含まれます。以後同様です。 $matches[0] には、マッチした文字列全体のコピーが含まれます。

戻り値

string 内に pattern にマッチする文字列があるかを返します。

変更履歴

バージョン説明

8.0.0 この関数は、成功時に true を返すようになりました。これより前のバージョンでは、 string 内に pattern にマッチする文字列が存在し、かつ matches が渡された場合、マッチした文字列のバイト長を返していました。 matches が渡されなかった場合、あるいはマッチした文字列の長さが 0 だった場合、この関数は 1 を返していました。

7.1.0 mb_eregi 関数は、何もマッチしなかった場合に matches に空の配列を設定するようになりました。これより前のバージョンでは、何もマッチしなかった場合に matches を変更しませんでした。

注意

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

参考

mb_regex_encoding
mb_ereg