preg_match_all

參數(shù)

pattern

要搜索的模式，字符串形式。

subject

輸入字符串。

matches

多維數(shù)組，作為輸出參數(shù)輸出所有匹配結(jié)果, 數(shù)組排序通過(guò)flags指定。

flags

可以結(jié)合下面標(biāo)記使用(注意不能同時(shí)使用PREG_PATTERN_ORDER和 PREG_SET_ORDER)：

PREG_PATTERN_ORDER

結(jié)果排序?yàn)?var class="varname">$matches[0]保存完整模式的所有匹配, $matches[1] 保存第一個(gè)子組的所有匹配，以此類(lèi)推。

<?php
preg_match_all("|<[^>]+>(.*)</[^>]+>|U",
    "<b>example: </b><div align=left>this is a test</div>",
    $out, PREG_PATTERN_ORDER);
echo $out[0][0] . ", " . $out[0][1] . "\n";
echo $out[1][0] . ", " . $out[1][1] . "\n";
?>

以上例程會(huì)輸出：

<b>example: </b>, <div align=left>this is a test</div>
example: , this is a test

因此, $out[0]是包含匹配完整模式的字符串的數(shù)組， $out[1]是包含閉合標(biāo)簽內(nèi)的字符串的數(shù)組。

如果正則表達(dá)式包含了帶名稱(chēng)的子組，$matches 額外包含了帶名稱(chēng)子組的鍵。

如果正則表達(dá)式里，子組名稱(chēng)重名了，則僅最右側(cè)的子組儲(chǔ)存在 $matches[NAME] 中。

<?php
preg_match_all(
    '/(?J)(?<match>foo)|(?<match>bar)/',
    'foo bar',
    $matches,
    PREG_PATTERN_ORDER
);
print_r($matches['match']);
?>

以上例程會(huì)輸出：

Array
(
    [0] => 
    [1] => bar
)

PREG_SET_ORDER

結(jié)果排序?yàn)?var class="varname">$matches[0]包含第一次匹配得到的所有匹配(包含子組)， $matches[1]是包含第二次匹配到的所有匹配(包含子組)的數(shù)組，以此類(lèi)推。

<?php
preg_match_all("|<[^>]+>(.*)</[^>]+>|U",
    "<b>example: </b><div align=\"left\">this is a test</div>",
    $out, PREG_SET_ORDER);
echo $out[0][0] . ", " . $out[0][1] . "\n";
echo $out[1][0] . ", " . $out[1][1] . "\n";
?>

以上例程會(huì)輸出：

<b>example: </b>, example:
<div align="left">this is a test</div>, this is a test

PREG_OFFSET_CAPTURE

如果這個(gè)標(biāo)記被傳遞，每個(gè)發(fā)現(xiàn)的匹配返回時(shí)會(huì)增加它相對(duì)目標(biāo)字符串的字節(jié)偏移量。 注意這會(huì)改變matches中的每一個(gè)匹配結(jié)果字符串元素，使其 成為一個(gè)第0個(gè)元素為匹配結(jié)果字符串，第1個(gè)元素為 匹配結(jié)果字符串在subject中的偏移量。

<?php
preg_match_all('/(foo)(bar)(baz)/', 'foobarbaz', $matches, PREG_OFFSET_CAPTURE);
print_r($matches);
?>

以上例程會(huì)輸出：

Array
(
    [0] => Array
        (
            [0] => Array
                (
                    [0] => foobarbaz
                    [1] => 0
                )

        )

    [1] => Array
        (
            [0] => Array
                (
                    [0] => foo
                    [1] => 0
                )

        )

    [2] => Array
        (
            [0] => Array
                (
                    [0] => bar
                    [1] => 3
                )

        )

    [3] => Array
        (
            [0] => Array
                (
                    [0] => baz
                    [1] => 6
                )

        )

)

PREG_UNMATCHED_AS_NULL

傳入此標(biāo)記，未匹配的子組報(bào)告為 null；否則會(huì)是空 string。

如果沒(méi)有給定排序標(biāo)記，假定設(shè)置為PREG_PATTERN_ORDER。

offset

通常， 查找時(shí)從目標(biāo)字符串的開(kāi)始位置開(kāi)始?？蛇x參數(shù)offset用于 從目標(biāo)字符串中指定位置開(kāi)始搜索(單位是字節(jié))。

注意:

使用 offset 參數(shù)不同于傳遞 substr($subject, $offset) 的 結(jié)果到 preg_match_all() 作為目標(biāo)字符串，因?yàn)?pattern 可以包含斷言比如^， $ 或者 (?<=x) 。 示例查看 preg_match()。