php man page for eregi

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)