XOOPS Brasil

 

ereg_replace

(PHP 4, PHP 5)

ereg_replaceSubstituição através de expressões regulares

Descrição

string ereg_replace ( string $pattern , string $replacement , string $string )

Essa função busca em string resultados para a pattern, substituindo se casar pelo texto replacement.

Parâmetros

pattern

A extendida expressão regular POSIX.

replacement

Se o pattern contém parênteses de substrings, a replacement será realizada através do formato \\digit, que indicará qual parte do texto substituido deverá ser retornado; \\0 retornará a string toda. Até nove substrings podem ser usadas. Os parênteses podem ser aninhados, sendo que a contagem será feita através da quantidade de parênteses abertos.

string

A string de entrada.

Valor Retornado

A string modificada é retornada. Se nenhuma substituição é feita na string, então retornará a string inalterada.

Exemplos

Por exemplo, o pedaço de código seguinte imprimirá "Esse foi um teste" três vezes:

Exemplo #1 Exemplo da ereg_replace()

<?php
$string 
"Esse e um teste";
echo 
str_replace(" e"" foi"$string);
echo 
ereg_replace("( )e""\\1foi"$string);
echo 
ereg_replace("(( )e)""\\2foi"$string);
?>

Preste atenção se usar uma variável integer no parâmetro substituicao, pois o resultado pode não ser exatamente o esperado. Isso acontece porque a função ereg_replace() interpreta o valor ordinal do número. Por exemplo:

Exemplo #2 Exemplo da ereg_replace()

<?php
/* Esse exemplo não funcionará. */
$num 5;
$string "Essa frase tem cinco palavras.";
$string ereg_replace('cinco'$num$string);
echo 
$string;   /* Resultado: 'Essa frase tem   palavras.' */

/* Esse exemplo funcionará. */
$num '5';
$string "Essa frase tem cinco palavras.";
$string ereg_replace('cinco'$num$string);
echo 
$string;   /* Resultado: 'Essa frase tem 5 palavras.' */
?>

Exemplo #3 Substitui URLs por links

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

Notas

Dica

preg_replace(), você pode também utilizar as expressões regulares compátiveis com perl, frequentemente uma alternativar veloz a função ereg_replace().

Veja Também

  • ereg() - Casando expressões regulares
  • eregi() - Casando expressões regulares insensíveis a maiúsculas e minúsculas
  • eregi_replace() - Substituição utilizando expressões regulares insensíveis a maiúsculas e minúsculas
  • str_replace() - Substitui todas as ocorrências da string de procura com a string de substituição
  • preg_match() - Perform a regular expression match