PHP preg_match_all() 函數

PHP 正則運算式(PCRE)PHP 正則運算式(PCRE)

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

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

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

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

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

返回值

返回完整匹配次數（可能是0），或者如果發生錯誤返回FALSE。

實例

查找匹配 <b> 與 </b> 標籤的內容：

<?php $userinfo = "Name: <b>PHP</b> <br> Title: <b>Programming Language</b>"; preg_match_all ("/<b>(.*)<\/b>/U", $userinfo, $pat_array); print_r($pat_array[0]); ?>

執行結果如下所示：

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

查找匹配的HTML標籤（貪婪）：

<?php //\\2是一個後向引用的示例. 這會告訴pcre它必須匹配正則運算式中第二個圓括號(這裏是([\w]+)) //匹配到的結果. 這裏使用兩個反斜線是因為這裏使用了雙引號. $html = "<b>bold text</b><a href=howdy.html>click me</a>"; preg_match_all("/(<([\w]+)[^>]*>)(.*?)(<\/\\2>)/", $html, $matches, PREG_SET_ORDER); foreach ($matches as $val) { echo "matched: " . $val[0] . "\n"; echo "part 1: " . $val[1] . "\n"; echo "part 2: " . $val[2] . "\n"; echo "part 3: " . $val[3] . "\n"; echo "part 4: " . $val[4] . "\n\n"; } ?>

執行結果如下所示：

matched: <b>bold text</b>
part 1: <b>
part 2: b
part 3: bold text
part 4: </b>

matched: <a href=howdy.html>click me</a>
part 1: <a href=howdy.html>
part 2: a
part 3: click me
part 4: </a>

PHP 正則運算式(PCRE)PHP 正則運算式(PCRE)