preg_replace_callback_array

(PHP 7, PHP 8)

preg_replace_callback_array — Здійснює пошук та заміну за регулярним виразом за допомогою функцій зворотного дзвінка.

Опис

preg_replace_callback_array(    array $pattern,    string|array $subject,    int $limit = -1,    int &$count = null,    int $flags = 0): string|array|null

Поведінка цієї функції схожа на preg_replace_callback(), за винятком того, що для кожного шаблону використовується своя функція зворотного дзвінка.

Список параметрів

pattern

Асоціативний масив, що зв'язує шаблони регулярного вираження (ключі) та callable(значения).

subject

Рядок, в якому буде здійснюватися пошук та заміна.

limit

Максимальна кількість замін для кожного шаблону в рядку subjectПо умолчанию-1 (без обмежень).

count

Якщо заданий, то в зазначену змінну буде записано кількість зроблених замін.

flags

flags може бути комбінацією прапорів **PREG_OFFSET_CAPTURE** і **PREG_UNMATCHED_AS_NULL**які впливають на формат масиву збігів. Дивіться опис у preg_match() для більш детальної інформації.

Значення, що повертаються

preg_replace_callback_array() повертає масив, якщо параметр subject є масивом та рядок, якщо рядком. У разі виникнення помилки повертається null

Якщо збіги знайдені, буде повернуто новий рядок, а якщо ні, то вихідний subject

Помилки

Якщо переданий шаблон регулярного виразу не компілюється в допустимий регулярний вираз, видається помилка рівня E_WARNING

список змін

Версия	Опис
7.4.0	Добавлен параметр`flags`

Приклади

Приклад #1 Приклад використання preg_replace_callback_array()****

Loading...

Результат виконання наведеного прикладу:

Найдено 6 совпадений "a"
Найдено 3 совпадений "b"

Дивіться також

Шаблони PCRE
preg_replace_callback() - Виконує пошук за регулярним виразом та заміною з використанням callback-функції
preg_quote() - Екранує символи у регулярних виразах
preg_replace() - Виконує пошук та заміну за регулярним виразом
preg_last_error() - Повертає код помилки виконання останнього регулярного вираження PCRE
Анонімні функції