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

# mb_ereg

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

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

### Описание

function 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() - Находит соответствие регулярному выражению с поддержкой многобайтовых символов без учёта регистра

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open