Version insensible à la casse de str_replace

# str_ireplace

(PHP 5, PHP 7)

str_ireplace — Version insensible à la casse de str_replace()

### Description

str_ireplace ( mixed `$search` , mixed `$replace` , mixed `$subject` [, int `&$count` ] ) : mixed

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 `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.

### 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