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 中。
在第一個匹配找到後, 子序列繼續從最後一次匹配位置搜索。
preg_match_all() 參數說明
$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用於 從目標字符串中指定位置開始搜索(單位是字節)。preg_match_all() 返回值
返回完整匹配次數(可能是0),或者如果發生錯誤返回FALSE。
preg_match_all() 實例
查找匹配 與 標籤的內容:
<?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>