PHP preg_match_all() 函數

preg_match_all 函數用於執行一個全域正規表示式匹配。

文法

int preg_match_all ( string $pattern , string $subject [, array &$matches [, int $flags = PREG_PATTERN_ORDER [, int $offset = 0 ]]] )

搜尋subject 中所有符合pattern 給定正規表示式的符合結果並且將它們以flag 指定順序輸出到matches 中。

在第一個匹配找到後, 子序列繼續從最後一次匹配位置搜尋。

參數說明：

$pattern: 要搜尋的模式，字串形式。

$subject: 輸入字串。

$matches: 多維數組，作為輸出參數輸出所有匹配結果, 數組排序透過flags指定。

$flags：可以結合下面標記使用(注意不能同時使用PREG_PATTERN_ORDER和PREG_SET_ORDER)：

PREG_PATTERN_ORDER: 結果排序為$matches[0]保存完整模式的所有匹配, $matches[1] 保存第一個子組的所有匹配，以此類推。

PREG_SET_ORDER: 結果排序為$matches[0]包含第一次匹配得到的所有匹配(包含子組)， $matches[1]是包含第二次匹配到的所有匹配(包含子組)的數組，以此類推。

PREG_OFFSET_CAPTURE: 如果這個標記被傳遞，每個發現的匹配回傳時會增加它相對目標字串的偏移量。

offset: 通常， 尋找時從目標字串的起始位置開始。可選參數offset用於從目標字串中指定位置開始搜尋(單位是位元組)。

傳回值

傳回完整符合次數（可能是0），或如果發生錯誤回傳FALSE。

實例

尋找符合<b> 與</b> 標籤的內容：

執行結果如下圖所示：

 Array( [0] => <b>PHP</b> [1] => <b>Programming Language</b>)

尋找符合的HTML標籤（貪婪）：

執行結果如下圖所示：

 matched: <b>bold text</b>part 1: <b>part 2: bpart 3: bold textpart 4: </b>matched: <a href=howdy.html>click me</a>part 1: <a href=howdy.html>part 2: apart 3: click mepart 4: </a>