preg_split

(PHP3 >= 3.0.9, PHP4 )

preg_split -- Split string by a regular expression

Description

array preg_split (string pattern, string subject [, int limit [, int flags]])

Note: 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 returned by preg_split().

Example 1. preg_split() 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().