Remplace toutes les occurrences d'une chaîne par une autre.
mixed str_replace
(mixed search, mixed replace, mixed subject)
str_replace() remplace toutes les occurrences de
search dans subject par
la chaîne replace. Si vous n'avez pas besoin de
règles de remplacement sophistiquées, utilisez str_replace()
de préférence à @xref{function.ereg-replace,,ereg_replace()} et
@xref{function.preg-replace,,preg_replace()}.
En PHP 4.0.5 et plus récent, chaque paramètre de
str_replace() peut être un tableau.
Si subject est un tableau, alors le remplacement
est effectué pour chaque valeur de subject, et la
valeur retournée sera un tableau.
Si search et replace sont
des tableaux, alors str_replace() prend une valeur dans
chaque tableau, et s'en sert pour chercher et remplacer dans
subject. Si replace contient
moins de valeurs que search, des chaînes vides seront
utilisées pour compléter le tableau replace.
Si search est un tableau et replace
est une chaîne, alors la même chaîne de remplacement
sera utilisée pour chaque valeur de search.
Le contraire n'aurait pas beaucoup de sens.
Exemple avec str_replace()
<?php
$bodytag = str_replace("%body%", "black", "<body text=%body%>");
?>
str_replace() n'altère pas les données binaires.
Note :
str_replace() a été ajoutée
en PHP 3.0.6, mais était erronée jusqu'à PHP 3.0.8.
Voir aussi
@xref{function.ereg-replace,,ereg_replace()},
@xref{function.preg-replace,,preg_replace()} et
strtr().
