mb_regex_set_options

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

mb_regex_set_optionsУстановка/получение значений по умолчанию для настроек функций mbregex

Описание

mb_regex_set_options(?string $options = null): string

Устанавливает параметры по умолчанию, описанные в 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 regex
g grep
c Emacs
r Ruby
z Perl
b POSIX Basic regex
d POSIX Extended regex

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

Предыдущие варианты. Если options опущен или равен null, он возвращает строку (string), которая описывает текущие параметры.

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

Версия Описание
8.0.0 Если параметр options задан и не равен null, возвращаются предыдущие параметры. Ранее возвращались текущие параметры.
8.0.0 Параметр options может принимать значение null.
8.0.0 Опция "e" теперь выбрасывает ошибку ValueError.
7.1.0 Опция "e" теперь выдаёт ошибку уровня ValueError.

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

  • mb_split() - Разделение строк в многобайтных кодировках, используя регулярное выражение
  • mb_ereg() - Совпадение с регулярным выражением с поддержкой многобайтовых кодировок
  • mb_eregi() - Поиск соответствий регулярному выражению с поддержкой многобайтовых символов без учёта регистра