diff --git a/functions/pcre.xml b/functions/pcre.xml index 6e0052c3f7..95c39dd01f 100644 --- a/functions/pcre.xml +++ b/functions/pcre.xml @@ -457,37 +457,56 @@ $text = preg_replace ($search, $replace, $document); + Parameter flags was added in PHP 4 Beta 3. + Returns an array containing substrings of subject split along boundaries matched by pattern. + If limit is specified, then only substrings up to limit are returned. + - If flags is PREG_SPLIT_NO_EMPTY then only non-empty pieces will - be by preg_split. + If flags is PREG_SPLIT_NO_EMPTY then only + non-empty pieces will be by preg_split. - - - Getting parts of search string - + + + <function>preg_split</function> example + + Get the parts of a search string. + + // split the phrase by any number of commas or space characters, // which include " ", \r, \t, \n and \f $keywords = preg_split ("/[\s,]+/", "hypertext language, programming"); - - + + + + Splitting a string into component characters. + + +$str = 'string'; +$chars = preg_split('//', $str, 0, PREG_SPLIT_NO_EMPTY); +print_r($chars); + + + + See also preg_match, preg_match_all, and preg_replace. + diff --git a/functions/regex.xml b/functions/regex.xml index d83712b61c..abf989347a 100644 --- a/functions/regex.xml +++ b/functions/regex.xml @@ -335,14 +335,23 @@ echo "Month: $month; Day: $day; Year: $year<br>\n"; + Note that pattern is case-sensitive. + Note that if you don't require the power of regular expressions, it is faster to use explode, which doesn't incur the overhead of the regular expression engine. + + + For users looking for a way to emulate perl's $chars = + split('', $str) behaviour, please see the examples for + preg_split. + + Please note that pattern is a regular expression. If you want to split on any of the characters which @@ -355,10 +364,12 @@ echo "Month: $month; Day: $day; Year: $year<br>\n"; something along the lines of man /usr/local/src/regex/regex.7 in order to read it. + See also: spliti, explode, and implode. +