$search
,$replace
,$subject
,&$count
= null
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
.
Pour remplacer un texte en fonction d'un modèle plutôt qu'une chaîne fixe, utilisez preg_replace() avec le modificateur de modèle 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 utilisé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.
search
La 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.
subject
Une 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.
count
Si fournie, cette variable contiendra le nombre de remplacements effectués.
Retourne une chaîne ou un tableau de remplacement.
Version | Description |
---|---|
8.2.0 | Le case folding ne dépend désormais plus de la locale définit avec setlocale(). Uniquement du case folding ASCII sera effectué. Les octets non-ASCII seront comparés par leur valeur d'octet. |
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.