str_ireplace() retourne une chaîne de caractères
ou un tableau dont toutes les occurrences de search
dans subject (en ignorant la casse), ont été
remplacées par la valeur de replace. Si vous n'avez
pas besoin de règles de recherche complexes, il est recommandé
d'utiliser cette fonction à la place de
preg_replace() avec l'option i.
Si les paramètres search et replace
sont des tableaux, alors la fonction str_ireplace()
prendra une valeur de chaque tableau et les utilisera pour la recherche et
le remplacement sur subject. Si le paramètre
replace a moins de valeurs que le paramètre
search, alors une chaîne de caractères vide sera utilisée
comme valeur pour le reste des valeurs de remplacement. Si le paramètre
search est un tableau et que le paramètre
replace est une chaîne de caractères, alors cette chaîne de caractères
de remplacement sera utililsée pour chaque valeur de search.
L'inverse n'a pas de sens.
Si le paramètre search ou le paramètre
replace sont des tableaux, leurs éléments sont traités
du premier au dernier.
searchLa valeur à chercher, connue aussi sous le nom de needle. Un tableau peut être utilisé pour désigner plusieurs needles.
replace
La valeur de remplacement utilisée pour chaque valeur trouvée
dans search. Un tableau peut être utilisé
pour désigner plusieurs remplacements.
subjectUne chaîne de caractères ou un tableau dans lequel la recherche s'effectue, aussi connu sous le nom de haystack.
Si subject est un tableau, le remplacement est
effectué sur chacun des éléments du sujet
subject, et la valeur retournée est aussi un
tableau.
countSi fournie, cette variable contiendra le nombre de remplacements effectués.
Retourne une chaîne ou un tableau de remplacement.
Exemple #1 Exemple avec str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>
Note: Cette fonction gère les chaînes binaires.
Vu le fait que la fonction str_ireplace() effectue les remplacements de la gauche vers la droite, elle peut remplacer une valeur précédemment insérée lors de remplacement multpiple. L'exemple #2 de la documentation de la fonction str_replace() sur la façon de traiter cette problématique.