(PHP 5, PHP 7, PHP 8)
str_ireplace — Version insensible à la casse de str_replace()
Description
str_ireplace(
array|string
$search
,
array|string
$replace
,
string|array
$subject
,
int
&$count
=
null
): string|array
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
..
Liste de paramètres
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.
Valeurs de retour
Retourne une chaîne ou un tableau de remplacement.
Historique
Exemples
Exemple #1 Exemple avec str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>
Notes
Note:
Cette fonction gère les chaînes binaires.
Attention
Ordre de remplacement
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.
Voir aussi
- str_replace() - Remplace toutes les occurrences dans une chaîne
- preg_replace() - Rechercher et remplacer par expression rationnelle standard
- strtr() - Remplace des caractères dans une chaîne