preg_split
(PHP 3>= 3.0.9, 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 起可用。
例子 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"); ?>
|
|
例子 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
)
) |
|
注:
flags 是 PHP 4 Beta 3 添加的。
参见 spliti(),split(),implode(),preg_match(),preg_match_all()
和 preg_replace()。