Функция 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,
която проверява съответствието с регулярен израз