str_replace
Remplace toutes les occurrences dans une chaîne
&reftitle.description;
mixedstr_replace
mixedsearch
mixedreplace
mixedsubject
intcount
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 (comme les
expressions rationnelles), utilisez cette fonction de préférence à
ereg_replace et preg_replace.
&reftitle.parameters;
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.
search
replace
subject
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.
count
Si fourni, contiendra le nombre de recherches et d'occurrences à remplacer.
&reftitle.returnvalues;
Cette fonction retourne une chaîne, ou un tableau, contenant les valeurs
remplacées.
&reftitle.changelog;
&Version;
&Description;
5.0.0
Ajout du paramètre count.
4.3.3
Le comportement de cette fonction a changée. Dans les
version précédentes, un bogue existait lors de l'utilisation
de tableaux avec les paramètres search et
replace en même temps. Les index de
search qui étaient vides étaient ignorés,
mais le pointeur interne de replace n'étais
pas incrémenté. Cela a été corrigé en PHP 4.3.3, tout script
s'appuyant sur ce bogue, doit supprimer les entrées vides avant
d'appeler cette fonction pour imiter le comportement d'origine.
4.0.5
Le plupart des paramètres peut maintenant être un tableau.
&reftitle.examples;
Exemple avec str_replace
$bodytag = str_replace("%body%", "black", "");
// Génère : Hll Wrld f PHP
$vowels = array("a", "e", "i", "o", "u", "A", "E", "I", "O", "U");
$onlyconsonants = str_replace($vowels, "", "Hello World of PHP");
// Génère : You should eat pizza, beer, and ice cream every day
$phrase = "You should eat fruits, vegetables, and fiber every day.";
$healthy = array("fruits", "vegetables", "fiber");
$yummy = array("pizza", "beer", "ice cream");
$newphrase = str_replace($healthy, $yummy, $phrase);
// Utilisation du compteur d'occurrences en PHP 5.0.0
$str = str_replace("ll", "", "good golly miss molly!", $count);
echo $count; // 2
// Ordre des remplacements
$str = "Line 1\nLine 2\rLine 3\r\nLine 4\n";
$order = array("\r\n", "\n", "\r");
$replace = '
';
// Traitement du premier \r\n, ils ne seront pas convertis deux fois.
$newstr = str_replace($order, $replace, $str);
// Affiche : apearpearle pear
$letters = array('a', 'p');
$fruit = array('apple', 'pear');
$text = 'a p';
$output = str_replace($letters, $fruit, $text);
echo $output;
?>
]]>
&reftitle.notes;
¬e.bin-safe;
Cette fonction est sensible à la casse. Utilisez la fonction
str_ireplace pour un remplacement insensible à la
casse.
&reftitle.seealso;
str_ireplace
substr_replace
preg_replace
strtr