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


返回一个数组,包含 subject 中沿着与 pattern 匹配的边界所分割的子串。 
如果指定了 limit,则最多返回 limit 个子串,如果 limit 是 -1,则意味着没有限制,可以用来继续指定可选参数 flags。 
flags 可以是下列标记的任意组合(用按位或运算符 | 组合): 

PREG_SPLIT_NO_EMPTY 
如果设定了本标记,则 preg_split() 只返回非空的成分。 

PREG_SPLIT_DELIM_CAPTURE 
如果设定了本标记,定界符模式中的括号表达式也会被捕获并返回。本标记添加于 PHP 4.0.5。 

PREG_SPLIT_OFFSET_CAPTURE 
如果设定了本标记,如果设定本标记,对每个出现的匹配结果也同时返回其附属的字符串偏移量。注意这改变了返回的数组的值,使其中的每个单元也是一个数组,其中第一项为匹配字符串,第二项为其在 subject 中的偏移量。本标记自 PHP 4.3.0 起可用。 
例子 1. preg_split() 例子 
<?
// 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"); 
?> 

例子 2. 将字符串分割成字符 
<?php 
$str = 'string'; 
$chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY); 
print_r($chars); 
?>

例子 3. 将字符串分割为匹配项及其偏移量 
<?php 
$str = 'hypertext language programming'; 
$chars = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE); 
print_r($chars); 
?>
 
本例将输出: 
Array 

    [0] => Array 
        ( 
            [0] => hypertext 
            [1] => 0 
        ) 

    [1] => Array 
        ( 
            [0] => language 
            [1] => 10 
        ) 

    [2] => Array 
        ( 
            [0] => programming 
            [1] => 19 
        ) 

)