preg_split
(PHP 4, PHP 5, PHP 7, PHP 8)
preg_split — 通過一個正規表示式分隔字串
說明
preg_split(
string
string
int
int
): array
string
$pattern,string
$subject,int
$limit = -1,int
$flags = 0): array
通過一個正規表示式分隔給定字串.
參數
-
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中的偏移量組成的陣列。
-
返回值
返回一個使用 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()。
小技巧
如果沒有成功匹配，將會返回一個陣列，包含了單個元素，即輸入的字串。
參見
- PCRE 模式
- preg_quote() - 轉義正規表示式字元
- implode() - 用字串連線陣列元素
- preg_match() - 執行匹配正規表示式
- preg_match_all() - 執行一個全域性正規表示式匹配
- preg_replace() - 執行一個正規表示式的搜索和替換
- preg_last_error() - 返回最後一個PCRE正則執行產生的錯誤程式碼