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

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

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

Окрім того, що функціональний блок PREG_FILTER повертає рядки (можливо, перетворені) лише при збігах, він ідентичний функціональному блоку PREG_REPLACE.

Вхід PATTERN

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

Вхід REPLACEMENT

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

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

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

Вхід SUBJECT

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

Вхід LIMIT

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

Вихід Q

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

Вихід COUNT

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