(PHP 4, PHP 5, PHP 7, PHP 8)
preg_split — 通过一个正则表达式分隔字符串
$pattern
,$subject
,$limit
= -1,$flags
= 0通过一个正则表达式分隔给定字符串.
pattern
用于搜索的模式,字符串形式。
subject
输入字符串
limit
如果指定,将限制分隔得到的子串最多只有limit
个,返回的最后一个
子串将包含所有剩余部分。limit
值为-1, 0或null时都代表"不限制"。
flags
flags
可以是任何下面标记的组合(以位或运算 |
组合):
PREG_SPLIT_NO_EMPTY
PREG_SPLIT_DELIM_CAPTURE
PREG_SPLIT_OFFSET_CAPTURE
如果这个标记被设置, 对于每一个出现的匹配返回时将会附加字符串偏移量.
注意:这将会改变返回数组中的每一个元素, 使其每个元素成为一个由第0
个元素为分隔后的子串,第1
个元素为该子串在subject
中的偏移量组成的数组。
返回一个使用 pattern
边界分隔 subject
后得到
的子串组成的数组, 或者在失败时返回 false
。
示例 #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 )
示例 #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 )
示例 #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()。
如果没有成功匹配,将会返回一个数组,包含了单个元素,即输入的字符串。