Funkcja preg_filter

Funkcja preg_filter wykonuje wyszukiwanie i zamianę w ciągu lub tablicy ciągów za pomocą wyrażenia regularnego. W przeciwieństwie do preg_replace, zwraca tylko te elementy, w których znaleziono dopasowanie. Pierwszy parametr przyjmuje wyrażenie regularne, drugi - ciąg zamiany, trzeci - ciąg lub tablicę do przetworzenia. W czwartym parametrze opcjonalnym można ustawić maksymalną liczbę zamian w każdym elemencie (domyślnie -1, co oznacza "bez ograniczeń"). W piątym parametrze opcjonalnym wskazuje się zmienną, do której zostanie zapisana liczba wykonanych zamian.

Składnia

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

Przykład

Zamieńmy wszystkie cyfry w ciągu na znak 'X':

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

Wynik wykonania kodu:

'aXbXcX'

Przykład

Przetwórzmy tablicę ciągów, zamieniając cyfry na '#':

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

Wynik wykonania kodu:

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

Przykład

Zademonstrujmy różnicę w stosunku do 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);
?>

Wynik wykonania kodu:

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

Zobacz też

funkcję preg_replace,
która wykonuje zamianę za pomocą wyrażenia regularnego
funkcję preg_match,
która sprawdza zgodność z wyrażeniem regularnym