Php/docs/function.preg-split

来自菜鸟教程
跳转至:导航、​搜索

preg_split

(PHP 4, PHP 5, PHP 7)

preg_split通过一个正则表达式分隔字符串


说明

preg_split ( string $pattern , string $subject [, int $limit = -1 [, int $flags = 0 ]] ) : array

通过一个正则表达式分隔给定字符串.


参数

pattern
用于搜索的模式,字符串形式。
subject
输入字符串
limit
如果指定,将限制分隔得到的子串最多只有limit个,返回的最后一个 子串将包含所有剩余部分。limit值为-1, 0或null时都代表"不限制"。
flags
flags 可以是任何下面标记的组合(以位或运算 | 组合):
PREG_SPLIT_NO_EMPTY
如果这个标记被设置, preg_split() 将仅返回分隔后的非空部分。
PREG_SPLIT_DELIM_CAPTURE
如果这个标记设置了,用于分隔的模式中的括号表达式将被捕获并返回。
PREG_SPLIT_OFFSET_CAPTURE
如果这个标记被设置, 对于每一个出现的匹配返回时将会附加字符串偏移量. 注意:这将会改变返回数组中的每一个元素, 使其每个元素成为一个由第0 个元素为分隔后的子串,第1个元素为该子串在subject 中的偏移量组成的数组。


返回值

返回一个使用 pattern 边界分隔 subject 后得到 的子串组成的数组, 或者在失败时返回 false


范例

Example #1 preg_split()示例:获取搜索字符串的部分

<?php//使用逗号或空格(包含" ", \r, \t, \n, \f)分隔短语$keywords = preg_split("/[\s,]+/", "hypertext language, programming");print_r($keywords);?>

以上例程会输出:


Array
(
    [0] => hypertext
    [1] => language
    [2] => programming
)

Example #2 将一个字符串分隔为组成它的字符

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

以上例程会输出:


Array
(
    [0] => s
    [1] => t
    [2] => r
    [3] => i
    [4] => n
    [5] => g
)

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
        )

)

注释

Tip 如果你不需要正则表达式功能,可以有更快(并且更简单)的选择比如 explode()str_split()


Tip 如果没有成功匹配,将会返回一个数组,包含了单个元素,即输入的字符串。


参见