eregi(3) [php man page]

EREGI(3)								 1								  EREGI(3)

eregi - Case insensitive regular expression match

SYNOPSIS

       int eregi (string  $pattern, string  $string, [array  &$regs])

DESCRIPTION

	This function is identical to ereg(3) except that it ignores case distinction when matching alphabetic characters.

       Warning

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

PARAMETERS

	      o $pattern
		- Case insensitive regular expression.

	      o $string
		- The input string.

	      o $regs
		-  If  matches	are  found  for parenthesized substrings of $pattern and the function is called with the third argument $regs, the
		matches will be stored in the elements of the array $regs.  $regs[1] will contain the substring which starts  at  the  first  left
		parenthesis;  $regs[2]	will contain the substring starting at the second, and so on. $regs[0] will contain a copy of the complete
		string matched.

RETURN VALUES

	Returns the length of the matched string if a match for $pattern was found in $string, or FALSE if no  matches	were  found  or  an  error
       occurred.

	If the optional parameter $regs was not passed or the length of the matched string is 0, this function returns 1.

EXAMPLES

       Example #1

	      eregi(3) example

	      <?php
	      $string = 'XYZ';
	      if (eregi('z', $string)) {
		  echo "'$string' contains a 'z' or 'Z'!";
	      }
	      ?>

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

	      eregi(3) is deprecated as of PHP 5.3.0. preg_match(3) with the i ( PCRE_CASELESS) modifier is the suggested alternative.

SEE ALSO

       ereg(3), ereg_replace(3), eregi_replace(3), preg_match(3), stripos(3), stristr(3), quotemeta(3).

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