(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
mb_regex_set_options — Устанавливает или получает значение по умолчанию для настроек функций mbregex
Устанавливает параметры по умолчанию, описанные в параметре options, для функций
регулярных выражений, работающих со строками в многобайтных кодировках.
optionsНастройки, которые нужно задать. Это строка, в которой каждый символ отвечает за какую-то настройку. Чтобы установить режим, необходимо указать его символ в конце строки, однако, можно задать только один режим, но несколько опций.
| Настройка | Описание | Список изменений |
|---|---|---|
| i | Включение неоднозначных совпадений | |
| x | Включает форму расширенного шаблона | |
| m | '.' совпадения с переводами строк |
|
| s | «^» → «\A», «$» → «\Z» |
|
| p | То же, что и объединение настроек m и s |
|
| l | Поиск совпадений с наибольшей длиной | |
| n | Игнорировать пустые совпадения | |
| e | Вычисление кода результата функцией eval() | Объявлено устаревшим в PHP 7.1.0 и удалено в PHP 8.0.0 |
Замечание:
Настройка
«e»не даёт эффекта при установке через функцию mb_regex_set_options(). Её указывают с функциями mb_ereg_replace() или mb_eregi_replace().
| Режим | Описание |
|---|---|
| j | Java (Sun java.util.regex) |
| u | Регулярные выражения GNU |
| g | grep |
| c | Emacs |
| r | Ruby |
| z | Perl |
| b | Регулярные выражения POSIX Basic |
| d | Регулярные выражения POSIX Extended |
Возвращает предыдущие настройки. Если параметр options опущен или равен null,
возвращает строку (string), которая описывает текущие параметры.
| Версия | Описание |
|---|---|
| 8.0.0 |
Если параметр options задан и не равен null,
возвращаются предыдущие
параметры. Ранее возвращались текущие параметры.
|
| 8.0.0 |
Параметр options теперь может принимать значение null.
|
| 8.0.0 |
Опция «e» теперь выбрасывает исключение ValueError.
|
| 7.1.0 |
Опция «e» теперь выдаёт ошибку уровня ValueError.
|