Funkce preg_filter

Funkce preg_filter provádí vyhledávání a nahrazování v řetězci nebo poli řetězců pomocí regulárního výrazu. Na rozdíl od preg_replace vrací pouze ty prvky, ve kterých byla nalezena shoda. Jako první parametr přijímá regulární výraz, jako druhý - řetězec pro nahrazení, jako třetí - řetězec nebo pole ke zpracování. Ve čtvrtém volitelném parametru lze zadat maximální počet nahrazení v každém prvku (ve výchozím nastavení -1, což znamená "bez omezení"). V pátém volitelném parametru se uvede proměnná, do které bude zapsán počet provedených nahrazení.

Syntaxe

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

Příklad

Nahradíme všechny číslice v řetězci symbolem 'X':

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

Výsledek provedení kódu:

'aXbXcX'

Příklad

Zpracujeme pole řetězců a nahradíme číslice znakem '#':

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

Výsledek provedení kódu:

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

Příklad

Předvedeme rozdíl oproti 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);
?>

Výsledek provedení kódu:

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

Viz také

funkci preg_replace,
která provádí nahrazování pomocí regulárního výrazu
funkci preg_match,
která ověřuje shodu s regulárním výrazem