preg_split

(PHP 4, PHP 5, PHP 7, PHP 8)

preg_split — 通過(guò)一個(gè)正則表達(dá)式分隔字符串

說(shuō)明

preg_split(
    string $pattern,
    string $subject,
    int $limit = -1,
    int $flags = 0
): array

通過(guò)一個(gè)正則表達(dá)式分隔給定字符串.

參數(shù)

pattern

用于搜索的模式，字符串形式。

subject

輸入字符串

limit

如果指定，將限制分隔得到的子串最多只有limit個(gè)，返回的最后一個(gè) 子串將包含所有剩余部分。limit值為-1， 0或null時(shí)都代表"不限制"。

flags

flags 可以是任何下面標(biāo)記的組合(以位或運(yùn)算 | 組合)：

PREG_SPLIT_NO_EMPTY
如果這個(gè)標(biāo)記被設(shè)置， preg_split() 將僅返回分隔后的非空部分。
PREG_SPLIT_DELIM_CAPTURE
如果這個(gè)標(biāo)記設(shè)置了，用于分隔的模式中的括號(hào)表達(dá)式將被捕獲并返回。
PREG_SPLIT_OFFSET_CAPTURE

如果這個(gè)標(biāo)記被設(shè)置, 對(duì)于每一個(gè)出現(xiàn)的匹配返回時(shí)將會(huì)附加字符串偏移量. 注意：這將會(huì)改變返回?cái)?shù)組中的每一個(gè)元素, 使其每個(gè)元素成為一個(gè)由第0 個(gè)元素為分隔后的子串，第1個(gè)元素為該子串在subject 中的偏移量組成的數(shù)組。

返回值

返回一個(gè)使用 pattern 邊界分隔 subject 后得到 的子串組成的數(shù)組， 或者在失敗時(shí)返回 false。

范例

示例 #1 preg_split()示例：獲取搜索字符串的部分

<?php
//使用逗號(hào)或空格(包含" ", \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
        )

)

注釋

小技巧

如果你不需要正則表達(dá)式功能，可以有更快(并且更簡(jiǎn)單)的選擇比如 explode() 或 str_split()。

小技巧

如果沒(méi)有成功匹配，將會(huì)返回一個(gè)數(shù)組，包含了單個(gè)元素，即輸入的字符串。

參見(jiàn)