Функциональный блок 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

Выход возвращает количество выполненных замен.