preg_filter(3) [php man page]

PREG_FILTER(3)								 1							    PREG_FILTER(3)

preg_filter - Perform a regular expression search and replace

SYNOPSIS

       mixed preg_filter (mixed  $pattern, mixed  $replacement, mixed  $subject, [int  $limit = -1], [int  &$count])

DESCRIPTION

       preg_filter(3)  is  identical  to  preg_replace(3)  except it only returns the (possibly transformed) subjects where there was a match. For
       details about how this function works, read the preg_replace(3) documentation.

RETURN VALUES

	Returns an array if the $subject parameter is an array, or a string otherwise.

	If no matches are found or an error occurred, an empty array is returned when $subject is an array or NULL otherwise.

EXAMPLES

       Example #1

	       Example comparing preg_filter(3) with preg_replace(3)

	      <?php
	      $subject = array('1', 'a', '2', 'b', '3', 'A', 'B', '4');
	      $pattern = array('/d/', '/[a-z]/', '/[1a]/');
	      $replace = array('A:$0', 'B:$0', 'C:$0');

	      echo "preg_filter returns
";
	      print_r(preg_filter($pattern, $replace, $subject));

	      echo "preg_replace returns
";
	      print_r(preg_replace($pattern, $replace, $subject));
	      ?>

	      The above example will output:

	      preg_filter returns
	      Array
	      (
		  [0] => A:C:1
		  [1] => B:C:a
		  [2] => A:2
		  [3] => B:b
		  [4] => A:3
		  [7] => A:4
	      )
	      preg_replace returns
	      Array
	      (
		  [0] => A:C:1
		  [1] => B:C:a
		  [2] => A:2
		  [3] => B:b
		  [4] => A:3
		  [5] => A
		  [6] => B
		  [7] => A:4
	      )

SEE ALSO

       PCRE Patterns, preg_quote(3), preg_replace(3), preg_replace_callback(3), preg_grep(3), preg_last_error(3).

PHP Documentation Group 													    PREG_FILTER(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)