Функция preg_filter

Функция preg_filter выполняет поиск и замену в строке или массиве строк по регулярному выражению. В отличие от preg_replace, она возвращает только те элементы, в которых было найдено совпадение. Первым параметром принимает регулярное выражение, вторым - строку замены, третьим - строку или массив для обработки. В четвертом необязательном параметре можно задать максимальное количество замен в каждом элементе (по умолчанию -1, что означает "без ограничений"). В пятом необязательном параметре указывается переменная, в которую будет записано количество выполненных замен.

Синтаксис

preg_filter(pattern, replacement, subject, [limit = -1], [count]);

Пример

Заменим все цифры в строке на символ 'X':

<?php
	$res = preg_filter('/\d/', 'X', 'a1b2c3');
	var_dump($res);
?>

Результат выполнения кода:

'aXbXcX'

Пример

Обработаем массив строк, заменив цифры на '#':

<?php
	$res = preg_filter('/\d/', '#', ['a1', 'b2', 'c', 'd4']);
	var_dump($res);
?>

Результат выполнения кода:

['a#', 'b#', 'd#']

Пример

Продемонстрируем отличие от preg_replace:

<?php
	$input = ['a1', 'b2', 'c', 'd4'];
	$res_filter = preg_filter('/\d/', '#', $input);
	$res_replace = preg_replace('/\d/', '#', $input);
	echo "Filter result: ";
	var_dump($res_filter);
	echo "Replace result: ";
	var_dump($res_replace);
?>

Результат выполнения кода:

Filter result: ['a#', 'b#', 'd#']
Replace result: ['a#', 'b#', 'c', 'd#']

Смотрите также

функцию preg_replace,
которая выполняет замену по регулярному выражению
функцию preg_match,
которая проверяет соответствие регулярному выражению