Función PHP preg_replace()
Ejemplo
Use una expresión regular que no distinga entre mayúsculas y minúsculas para reemplazar Microsoft con W3Schools en una cadena:
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo
preg_replace($pattern, 'W3Schools', $str);
?>
Definición y uso
La preg_replace()
función devuelve una cadena o matriz de cadenas donde todas las coincidencias de un patrón o una lista de patrones encontrados en la entrada se reemplazan con subcadenas.
Hay tres formas diferentes de utilizar esta función:
1. Un patrón y una cuerda de repuesto. Las coincidencias del patrón se reemplazan con la cadena de reemplazo.
2. Una matriz de patrones y una cadena de reemplazo. Las coincidencias con cualquiera de los patrones se reemplazan con la cadena de reemplazo.
3. Una matriz de patrones y una matriz de cadenas de reemplazo. Las coincidencias de cada patrón se reemplazan con la cadena de reemplazo en la misma posición en la matriz de reemplazos. Si no se encuentra ningún elemento en esa posición, la coincidencia se reemplaza con una cadena vacía.
Las cadenas de reemplazo pueden contener una referencia inversa en la forma \n o $n, donde n es el índice de un grupo en el patrón. En la cadena devuelta, las instancias de \n y $n se reemplazarán con la subcadena que coincidió con el grupo o, si se usan \0 o $0, con la expresión completa.
Nota: Para cada cadena de entrada, la función evalúa los patrones en el orden en que se dan. El resultado de evaluar el primer patrón de la cadena se utiliza como cadena de entrada para el segundo patrón y así sucesivamente. Esto puede conducir a un comportamiento inesperado.
Sintaxis
preg_replace(patterns, replacements, input, limit, count)
Valores paramétricos
Parameter | Description |
---|---|
patterns | Required. Contains a regular expression or array of regular expressions |
replacements | Required. A replacement string or an array of replacement strings |
input | Required. The string or array of strings in which replacements are being performed |
limit | Optional. Defaults to -1, meaning unlimited. Sets a limit to how many replacements can be done in each string |
count | Optional. After the function has executed, this variable will contain a number indicating how many replacements were performed |
Detalles técnicos
Valor devuelto: | Devuelve una cadena o una matriz de cadenas resultantes de aplicar los reemplazos a la cadena o cadenas de entrada |
---|---|
Versión PHP: | 4.0.5+ |
Registro de cambios: | PHP 5.1.0 - Se agregó el parámetro de conteo |
❮ Referencia PHP RegExp