str_ireplace

Manuel PHP
Précédent		Suivant

Description

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

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 qui est plus rapide que eregi_replace() ou preg_replace(), exploitant l'option i.

Si subject est un tableau, le remplacement est effectué sur chacun des éléments du sujet subject, et la valeur retournée est un aussi un tableau.

Si search et replace sont des tableaux, alors str_replace() prendra une valeur de chaque tableau, et l'utilisera pour faire le remplacement dans subject. Si replace a moins de valeurs que search, alors une chaîne vide sera utilisée pour effectuer les remplacements. Si search est un tableau et que replace est une chaîne, alors la chaîne de remplacement sera utilisée pour chaque élément de search.

Exemple 1. Exemple avec str_ireplace()


<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
?>

Cette fonction est compatible avec les données binaires.

Note : Depuis PHP 5.0, le nombre de valeurs de needle trouvées et remplacées sera retourné dans le paramètre count passé par référence. Avant PHP 5.0.0, ce paramètre n'est pas disponible.

Voir aussi str_replace(), preg_replace() et strtr().

Précédent	Sommaire	Suivant
str_getcsv	Niveau supérieur	str_pad