array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.mb-regex-set-options.php', 1 => 'mb_regex_set_options', 2 => 'Устанавливает или получает значение по умолчанию для настроек функций mbregex', ), 'up' => array ( 0 => 'ref.mbstring.php', 1 => 'Функции для работы с многобайтовыми строками', ), 'prev' => array ( 0 => 'function.mb-regex-encoding.php', 1 => 'mb_regex_encoding', ), 'next' => array ( 0 => 'function.mb-rtrim.php', 1 => 'mb_rtrim', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/mbstring/functions/mb-regex-set-options.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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
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.

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