str_replace() retourne une chaîne ou un tableau,
dont toutes les occurrences de search
dans
subject
ont été remplacées par
replace
. Si vous n'avez pas besoin de
règles de remplacement compliquées, utilisez cette fonction de
préférence à ereg_replace() et
preg_replace().
Depuis PHP 4.0.5, chaque paramètre de str_replace() peut être un tableau.
Avertissement |
Avant PHP 4.3.3, un bogue existait lors de l'utilisation de tableaux
avec les paramètres |
Si subject
est un tableau, alors le
remplacement se fera sur chaque élément de celui-ci, et
la valeur retournée sera aussi un tableau.
Si search
et
replace
sont des tableaux, alors
str_replace() prendra une valeur de chaque
tableau, et l'utilisera pour faire le remplacement dans
subject
. Si
replace
a moins de valeurs que
search
, alors une chaîne vide sera
utilisée pour effectuer les remplacements. Si search
est un tableau et que replace
est une
chaîne, alors la chaîne de remplacement sera utilisée pour chaque
élément de search
. Cependant, l'inverse n'aurait
aucun sens.
Si search
ou replace
sont des tableaux, les éléments sont traités du premier, au dernier.
Note : Cette fonction gère les chaînes binaires.
Note : Depuis PHP 5.0, le nombre de valeurs de
search
trouvées et remplacées seront retournées dans le paramètrecount
passé par référence. Avant PHP 5.0.0, ce paramètre n'est pas disponible.
Voir aussi str_ireplace(), substr_replace(), preg_replace() et strtr().
Précédent | Sommaire | Suivant |
str_repeat | Niveau supérieur | str_rot13 |