PHP – mb_eregi() 関数の使い方を解説

PHPのmb_eregi関数（multibyte regular expression ignore）は、マルチバイト文字列に対応した正規表現マッチングにおいて、大文字と小文字の違いを無視してパターン照合を行うための関数です。日本語などのマルチバイト文字を含む文字列に対しても、大文字小文字を区別せずに正規表現によるマッチングを実行できます。

構文

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

パラメータ

mb_eregi() は以下の3つのパラメータを受け取ります。

• pattern − 検索対象の文字列内でマッチさせたい正規表現パターンを指定します。

• string − パターンを検索する対象となる入力文字列を指定します。

• matches − 省略可能なパラメータです。パターンにマッチした部分文字列が配列 $matches の各要素に格納されます。マッチが見つからなかった場合は空の配列となります。

戻り値

この関数は、指定したパターンが文字列内でマッチしたかどうかを判定します。パターンがマッチした場合には整数値「1」を返し、マッチしなかった場合には false を返します。

使用例

<?php
   // UTF-8エンコーディングを設定
   $encoding = mb_regex_encoding("UTF-8");

   // パターンは "or"、検索対象の文字列は "Hello World"
   $integer = mb_eregi("or", "Hello World");

   // 結果を出力
   var_dump($encoding);
   print_r($integer);
?>

出力結果

bool(true)
1

この例では、"Hello World" の中に "or" というパターンが存在するため、mb_eregi() は整数値「1」を返します。また、mb_regex_encoding() によって内部エンコーディングが UTF-8 に設定されているため、var_dump() の出力は bool(true) となります。mb_eregi() は大文字小文字を区別しないため、たとえば "OR" や "Or" のようなパターンでも同様にマッチします。