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.
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.
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
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.str-ireplace.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
