Description
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.
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 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.
-
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
subjectest un tableau, le remplacement est effectué sur chacun des éléments du sujetsubject, 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
| Version | Description |
|---|---|
| 5.0.0 |
Ajout du paramètre count.
|
Exemples
Exemple #1 Exemple avec str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
?>Notes
Note: Cette fonction gère les chaînes binaires.
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
