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 |
Дивіться також
- mb_split() - Розділяє рядки в багатобайтних кодуваннях через регулярний вираз
- mb_ereg() - Знаходить збіг регулярного виразу за допомогою багатобайтових кодувань
- mb_eregi() - Знаходить відповідність регулярному виразу за допомогою багатобайтових символів без урахування регістру