mb_ereg
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
mb_ereg — Совпадение с регулярным выражением с поддержкой многобайтовых кодировок
Описание
$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() - Поиск соответствий регулярному выражению с поддержкой многобайтовых символов без учета регистра