Функция PHP preg_replace_callback()

PHP 正则表达式(PCRE)Регулярные выражения PHP (PCRE)

Функция preg_replace_callback() выполняет поиск по регулярному выражению и использует callback-функцию для выполнения замены.

Синтаксис

mixed preg_replace_callback ( mixed $pattern , callable $callback , mixed $subject [, int $limit = -1 [, int &$count ]] )

За исключением того, что вместо строки замены можно указать callback-функцию для вычисления строки замены, во всех остальных аспектах эта функция эквивалентна preg_replace().

Описание параметра:

  • $pattern: Шаблон для поиска. Может быть строкой или массивом строк.

  • $callback: callback-функция, которая вызывается каждый раз, когда требуется замена. Функция получает результаты совпадений из subject.

  • $subject: Целевая строка или массив строк для поиска и замены.

  • $limit: Необязательный. Максимально возможное число замен для каждого шаблона в каждой строке subject. По умолчанию -1 (без ограничений).

  • $count: Необязательный. Количество выполненных замен.

Возвращаемое значение

Если subject является массивом, preg_replace_callback() возвращает массив; в противном случае возвращает строку. В случае ошибки возвращает NULL.

Если совпадение найдено, возвращается заменённая целевая строка (или массив строк). В противном случае subject возвращается без изменений.

Примеры

Пример 1

<?php //Увеличить год в тексте на один год. $text = "День смеха — 04/01/2002\n"; $text.= "В прошлое Рождество было 12/24/2001\n"; //Callback-функция function next_year($matches) { //Обычно: $matches //$matches //и так далее return $matches[1].($matches[2]+1); } echo preg_replace_callback( "|(\d{2}/\d{2}/)(\d{4})|", "next_year", $text); ?>

Результат выполнения выглядит следующим образом:

April fools day is 04/01/2003
Last christmas was 12/24/2002

PHP 正则表达式(PCRE)Регулярные выражения PHP (PCRE)

Другие расширения