Función preg_replace

La función preg_replace busca en una string coincidencias con la expresión regular y las reemplaza por la string especificada. El primer parámetro acepta la expresión regular para la búsqueda, el segundo - la string de reemplazo, el tercero - la string original. Adicionalmente se puede especificar un límite de reemplazos y una variable para contar los reemplazos.

Sintaxis

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

Ejemplo

Reemplacemos todos los dígitos en la string por el símbolo 'X':

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

Resultado de ejecutar el código:

'aXbXcX'

Ejemplo

Reemplacemos solo las primeras 2 coincidencias:

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

Resultado de ejecutar el código:

'aXbXc3'

Ejemplo

Uso de referencias inversas en el reemplazo:

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

Resultado de ejecutar el código:

'World, Hello'

Ejemplo

Conteo del número de reemplazos realizados:

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

Resultado de ejecutar el código:

'Result: aXbXcX, Replacements: 3'

Ver también

la función preg_match,
que realiza búsqueda mediante expresión regular
la función preg_split,
que divide una string por expresión regular