str_ireplace

(PHP 5, PHP 7, PHP 8)

str_ireplace — Versione insensibile alle miuscole/minuscole di str_replace()

Descrizione

str_ireplace(
    mixed $search,
    mixed $replace,
    mixed $subject,
    int &$count = ?
): mixed

Questa funzione restituisce una stringa od un array 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 è un array, allora la ricerca e la sostituzione viene eseguita su ogni elemento di subject, ed il valore restituito è pure quello un array.

Se search e replace sono array, allora str_ireplace() prende i valori da ciascun array 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 è un array 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 count che 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().