PHP Velho Oeste 2024

mb_ereg_match

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

mb_ereg_matchマルチバイト文字列が正規表現に一致するか調べる

説明

mb_ereg_match(string $pattern, string $string, ?string $options = null): bool

マルチバイト文字列に対する正規表現マッチングを行います。

注意: この関数は、patternstring の先頭からマッチするかどうかを調べます。

パラメータ

pattern

正規表現パターン。

string

評価する文字列。

options

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

戻り値

string が正規表現 pattern に一致する場合にtrue 、 そうでない場合に false を返します。

変更履歴

バージョン 説明
8.0.0 options は、nullable になりました。

注意

注意:

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

参考

  • mb_regex_encoding() - 現在のマルチバイト正規表現用のエンコーディングを取得または設定する
  • mb_ereg() - マルチバイト対応の正規表現マッチ

add a note add a note

User Contributed Notes 3 notes

up
9
Anonymous
8 years ago
The behaviour of mb_ereg_match to imply a ^ at the beginning of the pattern stands in stark contrast to the behaviour of mb_ereg where ^ is NOT implied.

Switching between those two routines (because the need to extract a subpattern changes) requires careful consideration when to compensate for this surprising inconsistence.
up
8
Anonymous
15 years ago
Note that this function matches a string from the beginning only (though not necessarily till the end):

<?php

$test
= mb_ereg_match("a", "some apples"); // returns false
$test = mb_ereg_match("a", "a kiwi");      // returns true

?>

If you want to check for a match anywhere in the string, use the wild-card & repeat operators .*

<?php

$test
= mb_ereg_match(".*a", "some apples"); // returns true

?>
up
-1
webdesign at innato dot nl
5 years ago
It took me a while to discover that you must escape characters like parentheses (), square brackets [] and ^ (and maybe more) if you want to match these as a literal. Otherwise you may get some erratic outcome.

In summary, using a match anywhere in the string as an example:

<?php
$needle
= "[";
$haystack = "some_array[]";
$test= mb_ereg_match(".*".$needle, $haystack);   // returns false and a php warning

$test= mb_ereg_match('.*'.preg_quote($needle), $haystack);   // returns true
?>
To Top