preg_split

preg_split，是PHP函式。preg_split的語法為array preg_split ( string $pattern, string $subject [, int $limit [, int $flags]] )。

preg_split (PHP 3 >= 3.0.9, PHP 4, PHP 5)
preg_split -- 用正則表達式分割字元串

說明

array preg_split ( string pattern, string subject [, int limit [, int flags]] )
返回一個數組，包含 subject 中沿著與 pattern 匹配的邊界所分割的子串。
如果指定了 limit，則最多返回 limit 個子串，如果 limit 是 -1，則意味著沒有限制，可以用來繼續指定可選參數 flags。
flags 可以是下列標記的任意組合（用按位或運算符 | 組合）： PREG_SPLIT_NO_EMPTY 如果設定了本標記，則 preg_split() 只返回非空的成分。 PREG_SPLIT_DELIM_CAPTURE 如果設定了本標記，定界符模式中的括弧表達式也會被捕獲並返回。本標記添加於 PHP 4.0.5。 PREG_SPLIT_OFFSET_CAPTURE 如果設定了本標記，對每個出現的匹配結果也同時返回其附屬的字元串偏移量。注意這改變了返回的數組的值，使其中的每個單元也是一個數組，其中第一項為匹配字元串，第二項為其在 subject 中的偏移量。本標記自 PHP 4.3.0 起可用。

例子

preg_split()例子 $keywords = preg_split ("/[\s,]+/", "Hypertext language, programming"); ?>

結果如下：
Array ( [0] => hypertext [1] => language [2] => programming )

將字元串分割成字元

$str = 'string';
$chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY);
print_r($chars);
?>

將字元串分割為匹配項及其偏移量

$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
)
)