ereg

Last updated: Fri, 13 Nov 2009

ereg_replace

(PHP 4, PHP 5)

ereg_replace — Substituiçã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

ereg

Funções para Regex POSIX

Last updated: Fri, 13 Nov 2009

add a note User Contributed Notes
ereg_replace

Anonymous
06-Mar-2009 01:17


<?php


// highlights the recognized patterns (a good tool for experiments)





$output = ereg_replace("your regexp here", "<font color=red>\\0</font>", $input)


print $output;


?>

Real PHP Geek
01-Feb-2009 09:55


This function makes links unclickable, read the comments:



<?php

function strip_urls($text, $repPat)

{

    if(!$repPat){

        $repPat = "text [url]";

    }

    $aimpstr = 'PHP_STRIP_URLS_FUNCTION_BY_REAL-PHP-GEEK';

    //change $aimpstr to anything you want.

    $impstr = md5($aimpstr);

    $text = str_replace('</a>', '</a>' . $impstr, $text);

    $text = explode($impstr, $text);

    $n = 0;

    $texta = array();

    $repPat = str_ireplace(array('text', 'url'), array('\\4', '\\2'), $repPat);

    foreach ($text as $text) {

        $texta[$n] = ereg_replace("<a(.*)href=\"(.*)\"(.*)>(.*)</a>", $repPat, $text);

        $n++;

    }

    $textb = implode("</a>", $texta);

    return $textb;

}



//EXAMPLES:

$string_of_text = '<a href="http://www.php.net/">PHP</a> rocks. <a href="http://www.apache.org/">Apache</a> also!';

echo strip_urls($string_of_text, "text");

echo strip_urls($string_of_text, "url");

echo strip_urls($string_of_text, "text [url]");

echo strip_urls($string_of_text, NULL);

?>

computer_guru
06-Aug-2008 09:39


Here is the code I use to make links clickable. The code only works on xxxx:// (i.e. ftp://, http://, etc...). It does not work on www. because that is how I want it. The reason my code has an if condition is that it ignores html links and only modifies non-html urls. (see below)





<?php


function make_clickable($text)


{


    


    if (ereg("[\"|'][[:alpha:]]+://",$text) == false)


    {


        $text = ereg_replace('([[:alpha:]]+://[^<>[:space:]]+[[:alnum:]/])', '<a target=\"_new\" href="\\1">\\1</a>', $text);


    }


    return($text); 


}


?>





My function ignores code like this:





<a href="http://php.net"> php.net </a>





But it would make this one click able:





http://php.net

jammin320
03-Jul-2008 05:52


Just a quick addition to the last post - 



modifying the regular expression for the www clause to include a newline at the begining will allow it to catch URLs that are the first in a line but not the first in a string. The previous version would only catch them if a space preceded the value...



    // match www.something

    $text = ereg_replace("(^| |\n)(www([.]?[a-zA-Z0-9_/-])*)", "\\1<a href=\"http://\\2\">\\2</a>", $text);

http://www.bbgames.co.nr
04-May-2008 12:57


In response to a post above, his coding was a bit wrong.  The correct coding should be :



<?php

function hyperlink($text)

{

    // match protocol://address/path/

    $text = ereg_replace("[a-zA-Z]+://([.]?[a-zA-Z0-9_/-])*", "<a href=\"\\0\">\\0</a>", $text);



    // match www.something

    $text = ereg_replace("(^| )(www([.]?[a-zA-Z0-9_/-])*)", "\\1<a href=\"http://\\2\">\\2</a>", $text);



    // return $text

    return $text;

}

?>



You can use this function like this:

<?php

$line = "Check the links: www.yahoo.com http://www.php.net";

hyperlink($line);

// Now, all text that looks like a link becomes a link

?>

tugla
29-Feb-2008 03:29


If you're not relying on regular expressions, str_replace() can be far faster.

Renjith
20-Jan-2008 04:02


Code:



<?php



$s = "Coding PHP is fun.";



$pattern = "(.*)PHP(.*)";

$replacement = " They say \\1other languages\\2";



print ereg_replace($pattern, $replacement, $s);



?>



Output:

They say Coding other languages is fun.

Explanation:



"PHP" is replaced with "other languages", and the sentence is changed a little, using \1 and \2 to access the parts within parentheses.

http://php-regex.blogspot.com/

bjwarshaw2 at yahoo dot com
29-Sep-2007 11:27


It's worth mentioning for ultimate clarity that you're safest using double quotes when matching a pattern, since without them, metacharacters will be interpreted as a backslash plus another character. 



Granted, this is part of the language syntax for the string type, but it might not be quite so obvious when dealing with patterns in this function, which is taking the pattern as a parameter.



So if you find that '[\n]' is taking the 'n' out of your string and leaving the new lines alone, switch to doubles before changing anything else.

jarfil at jarfil dot net
26-Aug-2007 07:42


For simple patterns like "[a-z]", preg_replace is up to 6 times faster than ereg_replace.

mephissto at gmail dot com
30-May-2007 11:40


Your right but you just need to replace by :



<?php

function hyperlink(&$text)

{

    // match protocol://address/path/

    $text = ereg_replace("[a-zA-Z]+://([.]?[a-zA-Z0-9_/-])*", "<a href=\"\\0\">\\0</a>", $text);



    // match www.something

    $text = ereg_replace("(^| |.)(www([.]?[a-zA-Z0-9_/-])*)", "\\1<a href=\"http://\\2\">\\2</a>", $text);

}

?>

hoffaboffa (at) hotmail dott com
15-May-2007 11:03


cristiklein's hyperlink function is nice but works incorrect with a www-string like this



\r\nwww.google.se



then it does not become a hyperlink

bmcswee at gmail dot com dot invalid
06-Apr-2007 02:33


Function to strip an HTML tag out of a string. I use this in part for parsing XML documents.



<?php



function stripTags($tag, $string) {

        // Regular expressions only work with strings if the regexp has been pre-concocted

    $regExp = "<" . "$tag" . "[^>]*>";



    $string = str_replace("</$tag>", "", $string);

    $string = ereg_replace($regExp, "", $string);

    

    return $string;    

}



?>

Joachim Kruyswijk
25-May-2006 05:59


Use mb_ereg_replace() instead of ereg_replace() when working with multi-byte strings!

chrish at shield dot on dot ca
12-Feb-2006 11:43


I was having problems with Microsoft Outlook viewing forms within email.  I was only able to see the first word of the text box after I used the following code.



If I entered words into the text box and used the enter key to give me a CRLF I could see in the returned data the %0D%0A string, so I assumed if I just used the ereg-replace as below it would just replace the %0D%0A with a single space... 



function remove_extra_linebreaks($string) {

   $new_string=ereg_replace("%0D%0A", " ", $string);

  return $new_string;

}



But the form as displayed by Outlook only showed the text upto the first replaced string, then it was blank!

I could view the source of the email and it would show all of the text I expected.



The following will show the correct data in the form 



function remove_extra_linebreaks($string) {

   $new_string=ereg_replace("%0D%0A", '+', $string);

  return $new_string;

}

Chris
20-Jan-2006 05:43


I've updated the function a little that was posted below.  I use it to make database field names readable when making a header row.  I needed it to quit putting a space in "GPA" and to put a space in between numbers and letters.



<?php

/**

*  Converts "fieldcontainingGPAInMyDatabaseFrom2005"

*  To       "Field Containing GPA In My Database From 2005"

*/

function innerCapsToReadableText($text) {

    $text = ereg_replace("([A-Z]) ", "\\1",ucwords(strtolower(ereg_replace("[A-Z]"," \\0",$text))));

    return ereg_replace("([A-Za-z])([0-9])", "\\1 \\2", $text);

}

?>

codergeek42 at users dot sourceforge.net
21-Dec-2005 03:15


In response to "php dot net at lenix dot de," a cleaner (easier to read) method would be to type-cast the integer as a string by quoting it. For example:



<?php

$foo = 42;

echo ereg_replace ( "bar", "$foo" , "foobar" ); /* Would output "foo42". */

?>

benlanc at ster dot me dot uk
22-Aug-2005 08:49


Quite how I managed to get my previous post so wrong, I don't know. Correction follows:

<?php

/* function to turn InterCaps style strings (i.e. CSS Properties in Javascript) to human readable ones */

function deInterCaps($var){

   return ucfirst(strtolower(ereg_replace("[A-Z]"," \\0",$var)));

}



$interCapsString = "aLoadOfNonsenseToDemonstrateTheFunction";



echo deInterCaps($interCapsString);



// output: A load of nonsense to demonstrate the function

?>

php dot net at lenix dot de
07-Jul-2005 08:26


One thing to take note of is that if you use an integer value as the replacement parameter, you may not get the results you expect. This is because ereg_replace() will interpret the number as the ordinal value of a character, and apply that.



If you're ever having trouble with this one there's an easy workarround:



instead of 

<?php 

$foo = 23;

echo ereg_replace ( "bar", $foo , "foobar" );

?>



just do



<?php 

$foo = 23;

echo ereg_replace ( "bar", "" . $foo , "foobar" );

?>



to replace "bar" inside "foobar" with the string "23".

zaczek at gmail dot com
05-Jul-2005 09:09


If you want the function to process query strings, such as:



http://www.php.net/index.php?id=10%32&wp=test



modify the function as follows:



function hyperlink(&$text)

{

   // match protocol://address/path/

   $text = ereg_replace("[a-zA-Z]+://([-]*[.]?[a-zA-Z0-9_/-?&%])*", "<a href=\"\\0\">\\0</a>", $text);



   // match www.something

   $text = ereg_replace("(^| )(www([-]*[.]?[a-zA-Z0-9_/-?&%])*)", "\\1<a href=\"http://\\2\">\\2</a>", $text);

}

cristiklein at yahoo dot com
09-Apr-2005 07:50


Sometimes, you would like to match both styles of URL links that are common in chat windows:



http://www.yahoo.com

www.yahoo.com



You can do this by using the following code:



<?php

function hyperlink(&$text)

{

    // match protocol://address/path/

    $text = ereg_replace("[a-zA-Z]+://([.]?[a-zA-Z0-9_/-])*", "<a href=\"\\0\">\\0</a>", $text);



    // match www.something

    $text = ereg_replace("(^| )(www([.]?[a-zA-Z0-9_/-])*)", "\\1<a href=\"http://\\2\">\\2</a>", $text);

}

?>



You can use this function like this:

<?php

$line = "Check the links: www.yahoo.com http://www.php.net";

hyperlink($line);

// Now, all text that looks like a link becomes a link

?>

bgoodman at osogrande dot com
02-Mar-2005 08:25


When you are dealing with databases you can end up with quite a few \" to deal with.  To ereg_replace all these with something else it requires you to \ the \ and \ the " so you end up with:



$var1 = '\"';

$var2 = ereg_replace('\\\"','1234',$var1);



print $var2;  //this should print 1234

eerie at gmx dot net
27-Feb-2005 05:44


<?php $path = ereg_replace("\\", "/", $path); ?>

as posted from mmtach at yahoo dot com causes an error because you have to escape the backslash twice, once for the quotation marks and a second time due the posix syntax.

<?php $path = ereg_replace("\\\\", "/", $path); ?>

or

<?php $path = ereg_replace('\\', "/", $path); ?>

should both work as expected. since you don't have to escape the backslash in brackets (posix syntax) his alternative works also.

add a note

ereg

Funções para Regex POSIX

Last updated: Fri, 13 Nov 2009