mb_ereg

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

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, если шаблон pattern соответствует строке string, иначе false.

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

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

Примечания

Замечание:

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

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

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