Manuale PHP
Indietro |  | Avanti

# ereg_replace

(PHP 3, PHP 4, PHP 5)

ereg_replace -- Sostituzioni con espressioni regolari

## Descrizione

string ereg_replace ( string espressione_regolare, string testo_sostitutivo, string stringa )

La funzione ricerca all'interno del parametro stringa sottostringhe che incrocino con le condizioni specificate in espressione_regolare. Quando sono trovate, queste vengono sostituite con il testo specificato in testo_sostitutivo.

La funzione restituisce la stringa modificata. (Ciò implica che se non ci sono sottostringhe che soddisfino l' espressione regolare, la funzione restituisce la stringa originaria).

Se in espressione_regolare si specificano delle sottostringhe utilizzando le parentesi, anche nel campo testo_sostitutivo si possono specificare delle sottostringhe di formato \\digit , che saranno sostituite dalle stringhe soddisfacenti la digit'esima condizione posta tra parentesi; \\0 indica l'intera stringa. La funzione prevede che si possano utlizzare fino a nove sottostringhe. E' previsto che le parentesi siano nidificate, in questo caso il conteggio si basa sulle parentesi aperte.

Se nessuna parte di stringa viene riconosciuta, il parametro viene restituito invariato.

Come esempio il seguente frammento di codice visualizzerà la frase "Questo fu un test" tre volte:

Esempio 1. ereg_replace() esempio

`<?php $stringa = "Questo è un test"; echo ereg_replace(" è", " fu", $stringa); echo ereg_replace("( )è", "\\1fu", $stringa); echo ereg_replace("(( )è)", "\\2fu", $stringa); ?>`

Un aspetto a cui occorre prestare attenzione riguarda l'uso di numero intero per il parametro testo_sostitutivo, si potrebbero ottenere risultati diversi da quanto atteso. Questo accade perchè la funzione ereg_replace() interpreta il numero come posizione ordinale di un carattere comportandosi di conseguenza. Ad esempio:

Esempio 2. ereg_replace() esempio

`<?php
/* Questo non si comporta come atteso. */
$num = 4;
$stringa = "Questa stringa ha quattro parole.";
$stringa = ereg_replace('quattro', $num, $stringa);
echo $stringa; /* Risultato: 'Questa stringa ha parole.' */
/* Questo funziona. */
$num = '4';
$stringa = "Questa stringa ha quattro parole.";
$stringa = ereg_replace('quattro', $num, $stringa);
echo $stringa; /* Risultato: 'Questa stringa ha 4 parole' */
?>`

Esempio 3. Sostituzione di URL

`<?php $testo = ereg_replace("[[:alpha:]]+://[^<>[:space:]]+[[:alnum:]/]", "<a href=\"\\0\">\\0</a>", $testo); ?>`

> Suggerimento: Poichè utilizza espressioni regolari con sintassi compatibile con Perl, preg_replace(), è spesso una alternativa più veloce a ereg_replace().

Vedere anche ereg(), eregi(), eregi_replace(), str_replace() e preg_match().

Indietro | Partenza | Avanti
Funzioni per le espressioni regolari (POSIX estesa) | Risali | ereg