Функция preg_replace

Функцията preg_replace търси в низ съвпадения с регулярен израз и ги заменя с указания низ. Първият параметър приема регулярен израз за търсене, вторият - низ за замяна, третият - изходния низ. Допълнително може да се укаже лимит на заменките и променлива за броене на заменките.

Синтаксис

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

Пример

Нека заменим всички цифри в низа със символа 'X':

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

Резултат от изпълнението на кода:

'aXbXcX'

Пример

Нека заменим само първите 2 съвпадения:

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

Резултат от изпълнението на кода:

'aXbXc3'

Пример

Използване на обратни референции в замяната:

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

Резултат от изпълнението на кода:

'World, Hello'

Пример

Броене на броя извършени заменки:

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

Резултат от изпълнението на кода:

'Result: aXbXcX, Replacements: 3'

Вижте също

функцията preg_match,
която извършва търсене по регулярен израз
функцията preg_split,
която разделя низ по регулярен израз