A preg_replace függvény

A preg_replace függvény egy sztringben keres a reguláris kifejezéssel való egyezésekre és lecseréli azokat a megadott sztringre. Az első paramétere a keresendő reguláris kifejezés, a második a csere sztringje, a harmadik a forrássztring. Opcionálisan megadható a cserek korlátja és egy változó a cserek számolásához.

Szintaxis

preg_replace(pattern, replacement, subject, [limit], [count]);

Példa

Cseréljük le az összes számjegyet a sztringben a 'X' szimbólumra:

<?php
	$str = 'a1b2c3';
	$res = preg_replace('/\d/', 'X', $str);
	echo $res;
?>

A kód végrehajtásának eredménye:

'aXbXcX'

Példa

Cseréljük le csak az első 2 egyezést:

<?php
	$str = 'a1b2c3';
	$res = preg_replace('/\d/', 'X', $str, 2);
	echo $res;
?>

A kód végrehajtásának eredménye:

'aXbXc3'

Példa

Visszahivatkozások használata a csereben:

<?php
	$str = 'Hello World';
	$res = preg_replace('/(\w+)\s(\w+)/', '$2, $1', $str);
	echo $res;
?>

A kód végrehajtásának eredménye:

'World, Hello'

Példa

Az elvégzett cserék számának megszámlálása:

<?php
	$str = 'a1b2c3';
	$count = 0;
	$res = preg_replace('/\d/', 'X', $str, -1, $count);
	echo "Result: $res, Replacements: $count";
?>

A kód végrehajtásának eredménye:

'Result: aXbXcX, Replacements: 3'

Lásd még

a preg_match függvényt,
amely reguláris kifejezéssel történő keresést hajt végre
a preg_split függvényt,
amely egy sztringet reguláris kifejezés alapján darabol fel