# str_ireplace

(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

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

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

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.

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