mb_ereg

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

mb_eregСовпадение с регулярным выражением с поддержкой многобайтовых кодировок

Описание

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

Выполняет поиск совпадения с регулярным выражением с поддержкой многобайтовых кодировок.

Список параметров

pattern

Шаблон поиска.

string

Строка (string), в которой производится поиск.

matches

Если найдены совпадения для подстроки в скобках шаблона pattern и функция вызвана с третьим аргументом matches, совпадения будут сохранены в массиве matches. Если подобных совпадений найдено не будет, то matches установится как пустой массив.

$matches[1] будет содержать первую слева подстроку в скобках; $matches[2] - вторую, и так далее. $matches[0] будет содержать копию всей строки.

Возвращаемые значения

Возвращает true или false, в зависимости от того, найдено ли совпадение текста по шаблону pattern в строке string.

Список изменений

Версия Описание
8.0.0 Теперь, в случае успешного завершения, эта функция возвращает true. Раньше она возвращала длину найденого вхождения pattern в строке string в случае, если был передан параметр matches. Если опциональный параметр matches не был задан, или длина проверяемой строки равнялясь 0, эта функция возвращала число 1.
7.1.0 Теперь mb_ereg() устанавливает matches равным пустому массиву (array), если ничего не найдено. Ранее в этом случае matches оставался неизменным.

Примечания

Замечание:

Для этой функции будет использована внутренняя кодировка или кодировка, установленная функцией mb_regex_encoding().

Смотрите также

  • mb_regex_encoding() - Устанавливает/получает текущую кодировку для многобайтового регулярного выражения
  • mb_eregi() - Поиск соответствий регулярному выражению с поддержкой многобайтовых символов без учета регистра