str_replace

(PHP 3>= 3.0.6, PHP 4 )

str_replace --  Remplace toutes les occurrences dans une chaînes

Description

mixed str_replace ( mixed search, mixed replace, mixed subject)

str_replace() retourne une chaîne ou un tableau, dont toutes les occurences de search dans subject ont été remplacée 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().

En PHP 4.0.5 et plus récent, tous les paramèters de str_replace() peuvent être des tableaux.

Si subject est un tablaeu, alors le remplacement se fera sur chaque élément du tableau, 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.

Exemple 1. Exemple avec str_replace()

<?php
  $bodytag = str_replace("%body%", "black", "<body text=%body%>");
?>

str_replace() est compatible avec les chaînes binaires.

Note : str_replace() a été ajoutée en PHP 3.0.6, mais étaient buggée jusqu'en PHP 3.0.8.

Voir aussi ereg_replace(), preg_replace() et strtr().