preg_split

(PHP 4, PHP 5)

preg_split — 用正则表达式分割字符串

说明

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 起可用。

Tip

如果不需要正则表达式的功能，可以选择使用更快（也更简单）的替代函数如 explode() 或 str_split()。

Example#1 preg_split() 例子：取得搜索字符串的成分


<?php
// 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");
?>

Example#2 将字符串分割成字符


<?php
$str = 'string';
$chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY);
print_r($chars);
?>

Example#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
        )

)

Note: flags 是 PHP 4 Beta 3 添加的。

参见 spliti()，split()，implode()，preg_match()，preg_match_all() 和 preg_replace()。


	PHP5中文手册 PCRE PDF PCRE PHP Manual preg_split (PHP 4, PHP 5) preg_split — 用正则表达式分割字符串说明 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 起可用。 Tip 如果不需要正则表达式的功能，可以选择使用更快（也更简单）的替代函数如 explode() 或 str_split()。 Example#1 preg_split() 例子：取得搜索字符串的成分 `<?php // 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"); ?>` Example#2 将字符串分割成字符 `<?php $str = 'string'; $chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY); print_r($chars); ?>` Example#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 ) ) Note: `flags` 是 PHP 4 Beta 3 添加的。参见 spliti()，split()，implode()，preg_match()，preg_match_all() 和 preg_replace()。 PCRE PDF PCRE PHP Manual