str_replace
En esta página
str_replace
Reemplaza todas las ocurrencias en una string
Descripción#
str_replace(array $search, array $replace, string $subject, [int $count]): string
```php
`str_replace` devuelve una string o un array, donde todas las ocurrencias de `search` en `subject` han sido reemplazadas por `replace`.
Para reemplazar un texto en función de un patrón en lugar de una string fija, utilice `preg_replace`.
## Parámetros
Si los argumentos `search` y `replace` son arrays, entonces la función `str_replace` tomará un valor de cada array y los utilizará para la búsqueda y el reemplazo en `subject`. Si el argumento `replace` tiene menos valores que el argumento `search`, entonces una string vacía será utilizada como valor para el resto de los valores de reemplazo. Si el argumento `search` es un array y el argumento `replace` es una string, entonces esta string de reemplazo será utilizada para cada valor de `search`. Lo inverso no tiene sentido.
Si `search` o `replace` son arrays, los elementos son procesados del primero al último.
`search`
El valor a buscar, también conocido como *patrón*. Un array puede ser utilizado para designar múltiples patrones.
`replace`
El valor de reemplazo a sustituir por los valores encontrados. Un array puede ser utilizado para designar múltiples valores de reemplazo.
`subject`
La string o el array sobre el cual se realizará la búsqueda y el reemplazo, también conocido como *pajar*.
Si `subject` es un array, entonces el reemplazo se realizará en cada elemento del mismo, y el valor devuelto será también un array.
`count`
Si se proporciona, esta variable contendrá el número de reemplazos realizados.
## Valores devueltos
Esta función devuelve una string, o un array, conteniendo los valores reemplazados.
## Ejemplos
Ejemplo 1 con `str_replace`
Ejemplo 2 con `str_replace`
```php
Notas#
[!NOTE] Esta función es segura para sistemas binarios.
[!CAUTION] Debido a que la función
str_replacerealiza los reemplazos de izquierda a derecha, puede reemplazar un valor previamente insertado durante múltiples reemplazos.[!NOTE] Esta función es sensible a mayúsculas y minúsculas. Utilice la función
str_ireplacepara un reemplazo insensible a mayúsculas y minúsculas.
Véase también#
str_ireplace, substr_replace, preg_replace, strtr