Funkcia preg_filter

Funkcia preg_filter vykonáva vyhľadávanie a nahradzovanie v reťazci alebo poli reťazcov pomocou regulárneho výrazu. Na rozdiel od preg_replace vracia iba tie prvky, v ktorých bola nájdená zhoda. Prvým parametrom prijíma regulárny výraz, druhým - reťazec na nahradenie, tretím - reťazec alebo pole na spracovanie. Vo štvrtom voliteľnom parametre je možné nastaviť maximálny počet nahradení v každom prvku (predvolene -1, čo znamená "bez obmedzení"). V piatom voliteľnom parametri sa uvádza premenná, do ktorej sa zapíše počet vykonaných nahradení.

Syntax

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

Príklad

Nahradíme všetky číslice v reťazci znakom 'X':

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

Výsledok vykonania kódu:

'aXbXcX'

Príklad

Spracujeme pole reťazcov, pričom číslice nahradíme znakom '#':

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

Výsledok vykonania kódu:

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

Príklad

Ukážme rozdiel 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ýsledok vykonania kódu:

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

Pozri tiež

funkciu preg_replace,
ktorá vykonáva nahradzovanie pomocou regulárneho výrazu
funkciu preg_match,
ktorá kontroluje zhodu s regulárnym výrazom