Manuel PHP
Précédent |  | Suivant

# str_replace

(3.0.6 - 3.0.18 only, PHP 4 >= 4.0.0)

str_replace -- Remplace toutes les occurrences d'une chaîne par une autre.

## Description

``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 à ereg_replace() et 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 1. 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 ereg_replace(), preg_replace() et strtr().

Précédent | Sommaire | Suivant
strtoupper | Niveau supérieur | strtr