preg_split()

preg_split()是一個計算機函式，用於程式設計。

基本介紹

• 中文名：用正則表達式分割字元串
• 外文名：preg_split()
• 內容：(PHP 3>= 3.0.9, PHP 4 )
• 領域：程式設計

preg_split()

內容

(PHP 3>= 3.0.9, PHP 4 )

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 起可用。

用法及舉例

例1 將字元串分割成字元

<?php

$str = 'string';

$chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY);

print_r($chars);

?>

例2

<?php

// split the phrase by any number of commas or space characters,

// which include " ", \r, \t, \n and \f

$keywords = preg_split ("/[\s,]+/", "hypertext language, programming");

?>

例3

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

<?php

$str = 'hypertext language programming';

$chars = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE);

print_r($chars);

?>

本例將輸出：

Array

(