(PHP 4, PHP 5, PHP 7, PHP 8)
preg_split — 通過(guò)一個(gè)正則表達式分隔字符串
$pattern,$subject,$limit = -1,$flags = 0通過(guò)一個(gè)正則表達式分隔給定字符串.
pattern用于搜索的模式，字符串形式。
subject輸入字符串
limit
如果指定，將限制分隔得到的子串最多只有limit個(gè)，返回的最后一個(gè)
子串將包含所有剩余部分。limit值為-1， 0或null時(shí)都代表"不限制"。
flags
flags 可以是任何下面標記的組合(以位或運算 | 組合)：
PREG_SPLIT_NO_EMPTYPREG_SPLIT_DELIM_CAPTUREPREG_SPLIT_OFFSET_CAPTURE
如果這個(gè)標記被設置, 對于每一個(gè)出現的匹配返回時(shí)將會(huì )附加字符串偏移量.
注意：這將會(huì )改變返回數組中的每一個(gè)元素, 使其每個(gè)元素成為一個(gè)由第0
個(gè)元素為分隔后的子串，第1個(gè)元素為該子串在subject
中的偏移量組成的數組。
返回一個(gè)使用 pattern 邊界分隔 subject 后得到
的子串組成的數組， 或者在失敗時(shí)返回 false。
示例 #1 preg_split()示例：獲取搜索字符串的部分
<?php
//使用逗號或空格(包含" ", \r, \t, \n, \f)分隔短語(yǔ)
$keywords = preg_split("/[\s,]+/", "hypertext language, programming");
print_r($keywords);
?>
以上例程會(huì )輸出：
Array
(
[0] => hypertext
[1] => language
[2] => programming
)
示例 #2 將一個(gè)字符串分隔為組成它的字符
<?php
$str = 'string';
$chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY);
print_r($chars);
?>
以上例程會(huì )輸出：
Array
(
[0] => s
[1] => t
[2] => r
[3] => i
[4] => n
[5] => g
)
示例 #3 分隔一個(gè)字符串并獲取每部分的偏移量
<?php
$str = 'hypertext language programming';
$chars = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE);
print_r($chars);
?>
以上例程會(huì )輸出：
Array
(
[0] => Array
(
[0] => hypertext
[1] => 0
)
[1] => Array
(
[0] => language
[1] => 10
)
[2] => Array
(
[0] => programming
[1] => 19
)
)
如果你不需要正則表達式功能，可以有更快(并且更簡(jiǎn)單)的選擇比如 explode() 或 str_split()。
如果沒(méi)有成功匹配，將會(huì )返回一個(gè)數組，包含了單個(gè)元素，即輸入的字符串。