preg_split
通过一个正则表达式分隔字符串
&reftitle.description;
arrayfalsepreg_split
stringpattern
stringsubject
intlimit-1
intflags0
通过一个正则表达式分隔给定字符串.
&reftitle.parameters;
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
中的偏移量组成的数组。
&reftitle.returnvalues;
返回一个使用 pattern 边界分隔 subject 后得到
的子串组成的数组,&return.falseforfailure;。
&reftitle.errors;
&pcre.pattern.warning;
&reftitle.examples;
preg_split示例:获取搜索字符串的部分
]]>
&example.outputs;
hypertext
[1] => language
[2] => programming
)
]]>
将一个字符串分隔为组成它的字符
]]>
&example.outputs;
s
[1] => t
[2] => r
[3] => i
[4] => n
[5] => g
)
]]>
分隔一个字符串并获取每部分的偏移量
]]>
&example.outputs;
Array
(
[0] => hypertext
[1] => 0
)
[1] => Array
(
[0] => language
[1] => 10
)
[2] => Array
(
[0] => programming
[1] => 19
)
)
]]>
&reftitle.notes;
如果你不需要正则表达式功能,可以有更快(并且更简单)的选择比如 explode
或 str_split。
如果没有成功匹配,将会返回一个数组,包含了单个元素,即输入的字符串。
&reftitle.seealso;
PCRE 模式
preg_quote
explode
preg_match
preg_match_all
preg_replace
preg_last_error