preg_replace_callback

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

pattern

Искомый шаблон: строка или массив строк.

callback

Callback-функция для вызова и передачи массива совпадений, которые функция нашла в строке subject. Сигнатура callback-функции предусматривает возврат изменённой строки:

handler(array $matches): string

При вызове функции preg_replace_callback() callback-функцию часто вызывают однократно, поэтому для объявления обратного вызова внутри вызова функции preg_replace_callback() объявляют анонимную функцию. При таком способе организации кода информация о вызове собирается в одном месте и не загромождает текущее пространство имён названием callback-функции, которая не вызывается в другом месте.

Пример #1 Пример вызова функции preg_replace_callback() с анонимной callback-функцией

<?php

/* Фильтр командной строки в стиле Unix-систем
* для преобразования заглавных букв в начале параграфа в строчные */
$fp = fopen("php://stdin", "r") or die("не удалось прочесть stdin");
while (!feof($fp)) {
$line = fgets($fp);

$line = preg_replace_callback(
'|<p>\s*\w|',
function ($matches) {
return strtolower($matches[0]);
},
$line
);

echo $line;
}

fclose($fp);

?>

subject

Строка или массив строк для поиска и замены.

limit

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

count

При вызове с этим параметром переменная заполняется количеством замен, которые выполнила функция.

flags

Параметр flags принимает комбинацию флагов PREG_OFFSET_CAPTURE и PREG_UNMATCHED_AS_NULL, которые влияют на формат массива совпадений. Дополнительную информацию даёт описание функции preg_match().