mb_ereg_replace_callback
(PHP 5 >= 5.4.1, PHP 7, PHP 8)
mb_ereg_replace_callback — Виконує пошук та заміну за регулярним виразом за допомогою багатобайтових кодувань, обробляючи збіги callback-функцією
Опис
mb_ereg_replace_callback( string $pattern, callable $callback, string $string, ?string $options = null): string|false|null
Перевіряє рядок string на збіг із шаблоном patternпотім замінює знайдений текст виведенням функції callback
Поведінка цієї функції майже ідентична функції mb_ereg_replace(), за винятком того, що замість рядка заміни replacementнеобходимо определять функциюcallback
Список параметрів
pattern
Шаблон регулярного виразу.
В параметреpattern можна вказувати багатобайтові символи.
callback
Callback-функція, яка буде викликана і отримає масив тих, що збіглися в рядку string елементів. Callback-функція має повертати рядок заміни.
Передається до параметра callback функції mb_ereg_replace_callback() callback-функція часто потрібна лише одному місці. Можна використовувати анонімні функції, щоб визначити callback-функцію усередині виклику функції mb_ereg_replace_callback(). Вчиняючи так, розробник отримує всю інформацію про виклик в одному місці і не забруднює простір імен функцій ім'ям callback-функції, яка більше ніде не буде потрібна.
string
Рядок (string) для перевірки.
options
Варіант пошуку. Пояснення наведено в описі функції mb_regex_set_options()
Значення, що повертаються
Повертає результуючий рядок у разі успішного виконання або false у разі виникнення помилки. Якщо рядок string неприпустима для поточного кодування, повертається значення null
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | Параметрoptions тепер може набувати значення null. |
| 7.1.0 | Функція перевіряє, чи допустимий рядок string для поточного кодування. |
Приклади
Приклад #1 Приклад використання функції mb_ereg_replace_callback()****
Результат виконання наведеного прикладу:
День смеха - 04/01/2003
Последнее Рождество было 12/24/2002
Приклад #2 Приклад використання функції mb_ereg_replace_callback()** з анонімною функцією**
Примітки
Зауваження :
Для цієї функції буде використано внутрішнє кодування або кодування, встановлене функцією mb_regex_encoding()
Дивіться також
- mb_regex_encoding() - Встановлює/отримує кодування символів для однобайтового регулярного виразу
- mb_ereg_replace() - Замінює за регулярним виразом за допомогою багатобайтових кодувань
- Анонімні функції