ereg_replace(3) [php man page]

EREG_REPLACE(3) 							 1							   EREG_REPLACE(3)

ereg_replace - Replace regular expression

SYNOPSIS

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

DESCRIPTION

	This function scans $string for matches to $pattern, then replaces the matched text with $replacement.

       Warning

	      This function has been DEPRECATED as of PHP 5.3.0. Relying on this feature is highly discouraged.

PARAMETERS

	      o $pattern
		- A POSIX extended regular expression.

	      o $replacement
		-  If  $pattern contains parenthesized substrings, $replacement may contain substrings of the form  digit, which will be replaced
		by the text matching the digit'th parenthesized substring;  will produce the entire contents of string. Up  to  nine	substrings
		may be used. Parentheses may be nested, in which case they are counted by the opening parenthesis.

	      o $string
		- The input string.

RETURN VALUES

	The modified string is returned. If no matches are found in $string, then it will be returned unchanged.

EXAMPLES

	For example, the following code snippet prints "This was a test" three times:

       Example #1

	      ereg_replace(3) example

	      <?php

	      $string = "This is a test";
	      echo str_replace(" is", " was", $string);
	      echo ereg_replace("( )is", "\1was", $string);
	      echo ereg_replace("(( )is)", "\2was", $string);

	      ?>

	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(3) will interpret the number as the ordinal value of a character, and apply that. For instance:

       Example #2

	      ereg_replace(3) example

	      <?php
	      /* This will not work as expected. */
	      $num = 4;
	      $string = "This string has four words.";
	      $string = ereg_replace('four', $num, $string);
	      echo $string;   /* Output: 'This string has   words.' */

	      /* This will work. */
	      $num = '4';
	      $string = "This string has four words.";
	      $string = ereg_replace('four', $num, $string);
	      echo $string;   /* Output: 'This string has 4 words.' */
	      ?>

       Example #3

	      Replace URLs with links

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

NOTES

       Note

	      As of PHP 5.3.0, the regex extension is deprecated in favor of the PCRE extension. Calling this function will issue an  E_DEPRECATED
	      notice. See the list of differences for help on converting to PCRE.

       Tip

	      ereg_replace(3) is deprecated as of PHP 5.3.0. preg_replace(3) is the suggested alternative to this function.

SEE ALSO

       ereg(3), eregi(3), eregi_replace(3), str_replace(3), preg_replace(3), quotemeta(3).

PHP Documentation Group 													   EREG_REPLACE(3)

STR_REPLACE(3)								 1							    STR_REPLACE(3)

str_replace - Replace all occurrences of the search string with the replacement string

SYNOPSIS

       mixed str_replace (mixed  $search, mixed  $replace, mixed  $subject, [int  &$count])

DESCRIPTION

	This function returns a string or an array with all occurrences of $search in $subject replaced with the given $replace value.

	If you don't need fancy replacing rules (like regular expressions), you should always use this function instead of preg_replace(3).

PARAMETERS

	If  $search and $replace are arrays, then str_replace(3) takes a value from each array and uses them to search and replace on $subject. If
       $replace has fewer values than $search, then an empty string is used for the rest of  replacement  values.  If  $search	is  an	array  and
       $replace is a string, then this replacement string is used for every value of $search. The converse would not make sense, though.

	If $search or $replace are arrays, their elements are processed first to last.

	      o $search
		- The value being searched for, otherwise known as the needle. An array may be used to designate multiple needles.

	      o $replace
		- The replacement value that replaces found $search values. An array may be used to designate multiple replacements.

	      o $subject
		-  The	string or array being searched and replaced on, otherwise known as the haystack.  If $subject is an array, then the search
		and replace is performed with every entry of $subject, and the return value is an array as well.

	      o $count
		- If passed, this will be set to the number of replacements performed.

RETURN VALUES

	This function returns a string or an array with the replaced values.

EXAMPLES

       Example #1

	      Basic str_replace(3) examples

	      <?php
	      // Provides: <body text='black'>
	      $bodytag = str_replace("%body%", "black", "<body text='%body%'>");

	      // Provides: Hll Wrld f PHP
	      $vowels = array("a", "e", "i", "o", "u", "A", "E", "I", "O", "U");
	      $onlyconsonants = str_replace($vowels, "", "Hello World of PHP");

	      // Provides: You should eat pizza, beer, and ice cream every day
	      $phrase  = "You should eat fruits, vegetables, and fiber every day.";
	      $healthy = array("fruits", "vegetables", "fiber");
	      $yummy   = array("pizza", "beer", "ice cream");

	      $newphrase = str_replace($healthy, $yummy, $phrase);

	      // Provides: 2
	      $str = str_replace("ll", "", "good golly miss molly!", $count);
	      echo $count;
	      ?>

       Example #2

	      Examples of potential str_replace(3) gotchas

	      <?php
	      // Order of replacement
	      $str     = "Line 1
Line 2
Line 3
Line 4
";
	      $order   = array("
", "
", "
");
	      $replace = '<br />';

	      // Processes 
's first so they aren't converted twice.
	      $newstr = str_replace($order, $replace, $str);

	      // Outputs F because A is replaced with B, then B is replaced with C, and so on...
	      // Finally E is replaced with F, because of left to right replacements.
	      $search  = array('A', 'B', 'C', 'D', 'E');
	      $replace = array('B', 'C', 'D', 'E', 'F');
	      $subject = 'A';
	      echo str_replace($search, $replace, $subject);

	      // Outputs: apearpearle pear
	      // For the same reason mentioned above
	      $letters = array('a', 'p');
	      $fruit   = array('apple', 'pear');
	      $text    = 'a p';
	      $output  = str_replace($letters, $fruit, $text);
	      echo $output;
	      ?>

NOTES

       Note

	      This function is binary-safe.

       Caution

	      Replacement order gotcha

	       Because str_replace(3) replaces left to right, it might replace a previously inserted value when doing multiple	replacements.  See
	      also the examples in this document.

       Note

	       This function is case-sensitive. Use str_ireplace(3) for case-insensitive replace.

SEE ALSO

       str_ireplace(3), substr_replace(3), preg_replace(3), strtr(3).

PHP Documentation Group 													    STR_REPLACE(3)