preg_split
(PHP 4, PHP 5, PHP 7)
preg_split - 按正则表达式拆分字符串
描述
array preg_split ( string $pattern , string $subject [, int $limit = -1 [, int $flags = 0 ]] )用正则表达式分割给定的字符串。
参数
pattern
作为字符串搜索的模式。
subject
输入字符串。
limit
如果指定，则只有子字符串达到极限才返回，其余字符串放在最后一个子字符串中。 限制为-1,0或NULL意味着“没有限制”，并且，对于PHP中的标准，您可以使用NULL跳至flags参数。
flags
flags可以是以下标志（与组合的任何组合|位运算符）：
PREG_SPLIT_NO_EMPTY如果设置了此标志，preg_split（）将只返回非空片段。 PREG_SPLIT_DELIM_CAPTURE如果设置了此标志，则分隔符模式中的括号表达式将被捕获并返回。PREG_SPLIT_OFFSET_CAPTURE
如果设置了此标志，则对于每次发生的匹配，附属字符串偏移量也将被返回。 请注意，这会更改数组中的返回值，其中每个元素都是由偏移量为0的匹配字符串组成的数组，并且它的字符串偏移量为偏移量为1的主体。
返回值
返回一个数组，其中包含沿着与pattern匹配的边界分割的主题的子字符串，或者失败时返回FALSE。
例子
示例＃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");
print_r($keywords);
?>上面的例子将输出：
Array
(
[0] => hypertext
[1] => language
[2] => programming
)示例＃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
)
)注意
提示
如果你不需要正则表达式的力量，你可以选择更快（尽管比较简单），比如explode（）或str_split（）。
提示
如果匹配失败，将返回一个包含输入字符串的单个元素的数组。
扩展内容
- preg_quote（） - 引用正则表达式字符
- implode（） - 使用字符串加入数组元素
- preg_match（） - 执行正则表达式匹配
- preg_match_all（） - 执行全局正则表达式匹配
- preg_replace（） - 执行正则表达式搜索并替换
- preg_last_error（） - 返回上一次PCRE正则表达式执行的错误代码
← preg_replace
本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com
