Función PHP str_replace()
❮ Referencia de cadenas de PHP
Ejemplo
Reemplace los caracteres "mundo" en la cadena "¡Hola, mundo!" con "Pedro":
<?php
echo str_replace("world","Peter","Hello world!");
?>
Definición y uso
La función str_replace() reemplaza algunos caracteres con otros caracteres en una cadena.
Esta función funciona según las siguientes reglas:
- Si la cadena a buscar es una matriz, devuelve una matriz
- Si la cadena que se va a buscar es una matriz, la búsqueda y el reemplazo se realizan con cada elemento de la matriz.
- Si tanto buscar como reemplazar son matrices, y reemplazar tiene menos elementos que buscar, se usará una cadena vacía como reemplazo
- Si buscar es una matriz y reemplazar es una cadena, la cadena de reemplazo se usará para cada valor de búsqueda
Nota: Esta función distingue entre mayúsculas y minúsculas. Utilice la función str_ireplace() para realizar una búsqueda que no distinga entre mayúsculas y minúsculas.
Nota: Esta función es binariamente segura.
Sintaxis
str_replace(find,replace,string,count)
Valores paramétricos
Parameter | Description |
---|---|
find | Required. Specifies the value to find |
replace | Required. Specifies the value to replace the value in find |
string | Required. Specifies the string to be searched |
count | Optional. A variable that counts the number of replacements |
Detalles técnicos
Valor devuelto: | Devuelve una cadena o una matriz con los valores reemplazados |
---|---|
Versión PHP: | 4+ |
Registro de cambios: | El parámetro de conteo se agregó en PHP 5.0 Antes de PHP 4.3.3, esta función experimentaba problemas al usar arreglos como parámetros de búsqueda y reemplazo , lo que provocaba que se omitieran los índices de búsqueda vacíos sin avanzar el puntero interno en el arreglo de reemplazo . Las versiones más nuevas no tendrán este problema. A partir de PHP 4.0.5, la mayoría de los parámetros ahora pueden ser una matriz |
Más ejemplos
Ejemplo
Usando str_replace() con una matriz y una variable de conteo:
<?php
$arr = array("blue","red","green","yellow");
print_r(str_replace("red","pink",$arr,$i));
echo "Replacements: $i";
?>
Ejemplo
Usando str_replace() con menos elementos en replace que en find:
<?php
$find = array("Hello","world");
$replace = array("B");
$arr = array("Hello","world","!");
print_r(str_replace($find,$replace,$arr));
?>
❮ Referencia de cadenas de PHP