str_replace
Manual de PHP
AnteriorSiguiente

str_replace

(PHP 3 >= 3.0.6, PHP 4, PHP 5)

str_replace --  Sustitiye todas las apariciones de una cadena en otra

Descripci贸n

mixed str_replace ( mixed cadena_buscada, mixed cadena_sustituta, mixed cadena_original [, int &veces] )

Esta funci贸n sustituye todas las apariciones de la cadena_buscada en la cadena cadena_original por la cadena_sustituta dada. Si no precisa reglas especiales de sustituci贸n (como por ejemplo expresiones regulares), deber谩 usar siempre esta funci贸n en lugar de ereg_replace() o preg_replace().

Desde la versi贸n de PHP 4.0.5, todos los par谩metros de la funci贸n pueden ser de tipo array.

Aviso

En las versiones de PHP anteriores a la 4.3.3, exist铆 un error cuando se empleaban matrices como par谩metros cadena_buscada y cadena_sustituta que hac铆a que no se tuvieran en cuenta los 铆ndices vac铆os de cadena_buscada y por tanto no se avanzara en la matriz de forma sincronizada con la otra matriz cadena_sustituta. Los scripts que estaban preparados para tratar este error, deben eliminar los valores vac铆os de cadena_buscada antes de llamar a esta funci贸n para mantener el comportamiento original de la funci贸n.

Si cadena_original es una matriz, la b煤squeda y sustituci贸n se realiza en cada una de las entradas de cadena_original y por tanto, el valor devuelto tambi茅n es una matriz.

Si cadena_buscada y cadena_sustituta son matrices, la funci贸n str_replace() selecciona cada vez un valor de ambas matrices y realiza la b煤squeda/sustituci贸n. Si cadena_buscada tiene menos elementos que cadena_sustituta, se emplea una cadena vac铆a para realizar el resto de sustituciones. Si cadena_buscada es una matriz y cadena_sustituta es una cadena, se emplea esta cadena para realizar la sustici贸n de todos los valores de cadena_buscada.

Ejemplo 1. Ejemplo de str_replace()

<?php
// Obtiene: <body text='black'>
$etiqueta_body = str_replace("%body%", "black", "<body text='%body%'>");

// Obtiene: Hl Mnd d PHP
$vocales = array("a", "e", "i", "o", "u", "A", "E", "I", "O", "U");
$solo_consonantes = str_replace($vocales, "", "Hola Mundo de PHP");

// Obtiene: Debes comer pizza, cerveza y helados todos los dias
$frase_original  = "Debes comer frutas, verduras y fibra todos los dias";
$sano = array("frutas", "verduras", "fibra");
$sabroso   = array("pizza", "cerveza", "helados");

$nueva_frase = str_replace($sano, $sabroso, $frase_original);

// El parametro "veces" esta disponible desde la version de PHP 5.0.0
$cadena = str_replace("ll", "", "yo llevaba la llave", $numero_veces);
echo $numero_veces; // El valor de $numero_veces es: 2
?>

Nota: Esta funci贸n es segura binariamente.

Nota: Desde la versi贸n de PHP 5.0.0 el n煤mero de cadenas encontradas y sustituidas se devuelve en el par谩metro veces, que se pasa por referencia. En las versiones anteriores a PHP 5.0.0, este par谩metro no est谩 disponible.

Vea tambi茅n str_ireplace(), substr_replace(), ereg_replace(), preg_replace() y strtr().

AnteriorInicioSiguiente
str_repeatSubirstr_rot13