mb_ereg_replace(3) [php man page]

MB_EREG_REPLACE(3)							 1							MB_EREG_REPLACE(3)

mb_ereg_replace - Replace regular expression with multibyte support

SYNOPSIS

       string mb_ereg_replace (string  $pattern, string  $replacement, string  $string, [string  $option = "msr"])

DESCRIPTION

	Scans $string for matches to $pattern, then replaces the matched text with $replacement

PARAMETERS

	      o $pattern
		- The regular expression pattern.  Multibyte characters may be used in $pattern.

	      o $replacement
		- The replacement text.

	      o $string
		- The string being checked.

	      o $option
		-  Matching  condition	can  be  set by $option parameter. If i is specified for this parameter, the case will be ignored. If x is
		specified, white space will be ignored. If m is specified, match will be executed  in  multiline  mode	and  line  break  will	be
		included  in '.'. If p is specified, match will be executed in POSIX mode, line break will be considered as normal character. If e
		is specified, $replacement string will be evaluated as PHP expression.

RETURN VALUES

	The resultant string on success, or FALSE on error.

NOTES

       Note

	      The internal encoding or the character encoding specified by mb_regex_encoding(3) will be used as the character  encoding  for  this
	      function.

       Warning

	      Never  use  the  e  modifier when working on untrusted input. No automatic escaping will happen (as known from preg_replace(3)). Not
	      taking care of this will most likely create remote code execution vulnerabilities in your application.

SEE ALSO

       mb_regex_encoding(3), mb_eregi_replace(3).

PHP Documentation Group 													MB_EREG_REPLACE(3)

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)