Questa funzione restituisce una stringa od una matrice con tutte le occorrenze
di search in subject
(non distinguendo tra maiuscole e minuscole) sostituite con il valore replace
Se non occorrono particolari regole di sostituzione si dovrebbe utilizzare
questa funzione anziché eregi_replace() o
preg_replace() con il parametro i.
Se il parametro subject è una matrice, allora la ricerca
e la sostituzione viene eseguita su ogni elemento di
subject, ed il valore restituito è pure quello una
matrice.
Se search e
replace sono matrici, allora
str_ireplace() prende i valori da ciascuna matrice
e li utilizza per fare la ricerca e la sostituzione in
subject. Se
replace ha meno valori di
search, allora si utilizza una stringa vuota per sostituire
i valori mancanti. Se search
è una matrice e replace è una stringa; allora
questa stringa viene utilizzata per sostituire ogni valore di
search.
Example #1 Esempio di uso di str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
?>
Questa funzione è sicura con i dati binari.
Nota: Dal PHP 5.0.0 il numero dei testi trovati e sostituiti sarà restituito in
countche deve essere passato per riferimento. Prima del PHP 5.0.0 questo parametro non è disponibile.
Vedere anche: str_replace(), ereg_replace(), preg_replace() e strtr().