PHP preg_split() 函数 - PHP 5 函数参考手册

PHP preg_spllit() 函数通过一个正则表达式分隔字符串

函数原型

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

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

参数

$pattern

用于搜索的模式，字符串形式

$subject

要分割的字符串

$limit

可选
如果指定，将限制分隔得到的子串最多只有 limit 个，返回的最后一个子串将包含所有剩余部分

limit 值为 -1， 0 或 null 时都代表 "不限制"

$flag

可选

可以使用 NULL 跳过对 flags 的设置

可以是任何下面标记的组合(以位或运算 | 组合)：

PREG_SPLIT_NO_EMPTY

如果这个标记被设置， preg_split() 将进返回分隔后的非空部分
PREG_SPLIT_DELIM_CAPTURE

如果这个标记设置了，用于分隔的模式中的括号表达式将被捕获并返回
PREG_SPLIT_OFFSET_CAPTURE

如果这个标记被设置, 对于每一个出现的匹配返回时将会附加字符串偏移量

这将会改变返回数组中的每一个元素, 使其每个元素成为一个由
第 0 个元素为分隔后的子串
第1个元素为该子串在subject 中的偏移量组成的数组

返回值

返回一个使用 pattern 边界分隔 subject 后得到的子串组成的数组

范例

下面的代码将字符串分割成一个一个单词下面的代码获取搜索字符串的部分

<?php
//使用逗号或空格(包含" ", \r, \t, \n, \f)分隔短语

$txt = "hypertext language, programming"
$keywords = preg_split("/[\s,]+/", $txt);
print_r($keywords);

运行以上 PHP 范例，输出结果如下

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

范例 2

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

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

运行以上 PHP 范例，输出结果如下

Array
(
    [0] => r
    [1] => u
    [2] => n
    [3] => o
    [4] => o
    [5] => b
)

范例 3

分隔一个字符串并获取每部分的偏移量

<?php
$str = 'hypertext language programming';
$chars = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE);
print_r($chars);

运行以上 PHP 范例，输出结果如下

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

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

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

)