Funktio preg_filter

Funktio preg_filter suorittaa haun ja korvauksen merkkijonossa tai merkkijonotaulukossa säännöllisen lausekkeen avulla. Toisin kuin preg_replace, se palauttaa vain ne alkiot, joissa löytyi vastaavuus. Ensimmäisenä parametrina se vastaanottaa säännöllisen lausekkeen, toisena - korvausmerkkijonon, kolmantena - käsiteltävän merkkijonon tai taulukon. Neljännessä valinnaisessa parametrissa voidaan asettaa enimmäismäärä korvauksia kussakin alkiossa (oletusarvoisesti -1, mikä tarkoittaa "ei rajoituksia"). Viidennessä valinnaisessa parametrissa määritetään muuttuja, johon tallennetaan suoritettujen korvausten määrä.

Syntaksi

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

Esimerkki

Korvataan kaikki numerot merkkijonossa symbolilla 'X':

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

Koodin suorituksen tulos:

'aXbXcX'

Esimerkki

Käsitellään merkkijonotaulukko korvaamalla numerot symbolilla '#':

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

Koodin suorituksen tulos:

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

Esimerkki

Esitetään ero preg_replace:hen verrattuna:

<?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);
?>

Koodin suorituksen tulos:

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

Katso myös

funktion preg_replace,
joka suorittaa korvauksen säännöllisellä lausekkeella
funktion preg_match,
joka tarkistaa vastaavuuden säännölliseen lausekkeeseen