Функціональний блок PREG_REPLACE

Функціональний блок PREG_REPLACE шукає та замінює за допомогою регулярних виразів.

Примітка: Ця функція є Binary-Safe. Це означає, що UTF8-символи не можуть бути безпосередньо оброблені.

Вхід PATTERN

Вираз у вигляді рядка, за яким шукається. Також доступні деякі модифікатори PCRE.

Вхід REPLACEMENT

Рядок для замінювання. Він може містити посилання у формі \n або $n, при цьому останній варіант є переваженим. Кожне з цих посилань замінюється текстом, який був захоплений n-м у дужках шаблоном для пошуку. n може мати значення від 0 до 99. \0 або $0 посилаються на текст, який відповідає повному шаблону для пошуку. Щоб отримати номер захоплюючого підшаблону для пошуку, відкривальні дужки рахуються зліва направо, починаючи з 1. Щоб використати обернуту косу риску у замінюванні, її потрібно подвоїти "\\".

Якщо ви хочете працювати з замінюванням, в якому безпосередньо після посилання на повернення слідує інше число (тобто, відразу після відповідності шаблону для пошуку має йти число), то ви не можете використовувати запис \1 для свого посилання на повернення. Наприклад, \11 сплутає функцію, тому що вона не знає, чи ви хочете посилання на повернення \1, за яким слідує число 1, або лише посилання на повернення \11. У цьому випадку рішенням є використання ${1}1. Таким чином створюється ізольоване посилання на повернення $1, а 1 залишається символом літери.

Якщо ви використовуєте застарілий модифікатор e, ця функція маскує деякі символи (а саме ', ", \ та NULL) у рядках, якими замінюються посилання на повернення. Це робиться для того, щоб гарантувати відсутність помилок синтаксису при використанні посилань на повернення, які містять одинарні або подвійні лапки. Переконайтеся, що ви знаєте синтаксис рядків, щоб точно знати, як виглядає оцінювана строка.

Вхід SUBJECT

Вхід визначає рядок для пошуку.

Вхід LIMIT

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

Вихід Q

Якщо були знайдені відповідності, то новий рядок Q повертається, інакше SUBJECT повертається незмінним або NULL, якщо сталася помилка.

Вихід COUNT

Вихід повертає кількість виконаних замінювань.