[Stringhe] str_replace();

[Samyorn]

PHP 4, 5
Sintassi: mixed str_replace (mixed $search, mixed $replace, mixed $subject[, int $count])


str_replace è una funzione di PHP che restituisce una stringa, o una matrice, sostituendo il valore (o i valori come vedremo di seguito) del parametro $replace a tutte le occorrenze $search contenute in $subject.

Codice PHP:

<?
$str = 'Questo è un esempio';
$str = str_replace('un esempio', 'PHP', $str);
echo $str; // risultato: Questo è PHP
?>

Dalla versione 5.0.0 di PHP è stato introdotto il parametro $count che restituisce il numero di occorrenze $search sostituite con il parametro $replace in $subject.

Codice PHP:

<?
$str = 'Mollo';
$str = str_replace ('l', 't', $str, $count);
echo $count; // risultato: 2
?>

I parametri $search , $replace ed $subject possono essere anche degli array.
Qualora $subject fosse un array verranno sostituite tutte le occorrenze di ogni elemento di $subject.

Codice PHP:

<?
$str[0] = 'Mollo';
$str[1] = 'Bollo';
$str = str_replace ('ll', 'tt', $str);
echo $str[0]; // risultato: Motto
echo $str[1]; // risultato: Botto
?>

Se $search è un'array, ogni elemento dell'array verrà sostituito con il parametro $replace:

Codice PHP:

<?
$str = 'Questo è un esempio';
$voc = array ('a', 'e', 'i', 'o', 'u');
$str = str_replace ($voc, '', $str);
echo $str; // risultato: Qst è n smp
?>

Qualora $search ed $replace siano degli array con eguale numero di elementi, questi verranno sostituiti mantenendo l'ordine degli elementi che li costituiscono. Se gli elementi di $replace sono inferiori a quelli di $search, i rimanenti elementi di $search verranno sostituiti con stringhe vuote.

Codice PHP:

<?
$str = 'Bevo tanta acqua, poco vino e mangio sempre';
$search = array ('tanta', 'poco', 'mangio');
$replace = array ('poca', 'molto', 'corro');
$str = str_replace ($search, $replace, $str);
echo $str; // risultato: Bevo poca acqua, molto vino e corro sempre :D
 
$str = 'Bevo tanta acqua, poco vino e mangio sempre';
$search = array ('tanta', 'poco', 'sempre');
$replace = array ('poca', 'molto');
$str = str_replace ($search, $replace, $str);
echo $str; // risultato: Bevo poca acqua, molto vino e mangio
?>

Questa funzione è case sensitive pertanto il seguente codice potrebbe produrre risultati inaspettati:

Codice PHP:

 $str = 'Questo è un esempio';
$voc = array ('a', 'E', 'i', 'O', 'u');
$str = str_replace ($voc, '', $str);
echo $str; // risultato: Qesto è n esempo
?> 


L’equivalente, non case sensitive, di questa funzione è str_ireplace();