ereg(3) [php man page]

EREG(3) 								 1								   EREG(3)

ereg - Regular expression match

SYNOPSIS

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

DESCRIPTION

	Searches a $string for matches to the regular expression given in $pattern in a case-sensitive way.

       Warning

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

PARAMETERS

	      o $pattern
		- Case sensitive 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.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 4.1.0	|						    |
       |	|						    |
       |	|  Up  to  (and  including) PHP 4.1.0 $regs will be |
       |	| filled with exactly  ten  elements,  even  though |
       |	| more	or  fewer than ten parenthesized substrings |
       |	| may actually have matched. This has no effect  on |
       |	| ereg(3)'s ability to match more substrings. If no |
       |	| matches are found, $regs will not be	altered  by |
       |	| ereg(3).					    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      ereg(3) example

	       The following code snippet takes a date in ISO format (YYYY-MM-DD) and prints it in DD.MM.YYYY format:

	      <?php
	      if (ereg ("([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})", $date, $regs)) {
		  echo "$regs[3].$regs[2].$regs[1]";
	      } else {
		  echo "Invalid date format: $date";
	      }
	      ?>

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(3) is deprecated as of PHP 5.3.0. preg_match(3) is the suggested alternative to this function.

SEE ALSO

       eregi(3), ereg_replace(3), eregi_replace(3), preg_match(3), strpos(3), strstr(3), quotemeta(3).

PHP Documentation Group 														   EREG(3)

Check Out this Related Man Page

SPLITI(3)								 1								 SPLITI(3)

spliti - Split string into array by regular expression case insensitive

SYNOPSIS

       array spliti (string  $pattern, string  $string, [int  $limit = -1])

DESCRIPTION

	Splits a $string into array by regular expression.

	This function is identical to split(3) except that this 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.   If you want to split on any of the characters which are considered special by regular
		expressions, you'll need to escape them first. If you think spliti(3) (or any other regex function,  for  that	matter)  is  doing
		something  weird,  please read the file regex.7, included in the regex/ subdirectory of the PHP distribution. It's in manpage for-
		mat, so you'll want to do something along the lines of man /usr/local/src/regex/regex.7 in order to read it.

	      o $string
		- The input string.

	      o $limit
		- If $limit is set, the returned array will contain a maximum of $limit elements with the last element containing the  whole  rest
		of $string.

RETURN VALUES

	Returns  an  array of strings, each of which is a substring of $string formed by splitting it on boundaries formed by the case insensitive
       regular expression $pattern.

	If there are n occurrences of $pattern, the returned array will contain n+1 items. For example, if there is no occurrence of $pattern,	an
       array  with  only  one  element	will  be returned. Of course, this is also true if $string is empty. If an error occurs, spliti(3) returns
       FALSE.

EXAMPLES

	This example splits a string using 'a' as the separator :

       Example #1

	      spliti(3) example

	      <?php
	      $string = "aBBBaCCCADDDaEEEaGGGA";
	      $chunks = spliti ("a", $string, 5);
	      print_r($chunks);
	      ?>

	      The above example will output:

	      Array
	      (
		[0] =>
		[1] => BBB
		[2] => CCC
		[3] => DDD
		[4] => EEEaGGGA
	      )

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

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

SEE ALSO

       preg_split(3), split(3), explode(3), implode(3).

PHP Documentation Group 														 SPLITI(3)

Linux and UNIX Man Pages

ereg(3) [php man page]

Check Out this Related Man Page