preg_match_all

參數

pattern

要搜尋的模式，為字串。

subject

輸入字串。

matches

根據 flags 排序的多維陣列中所有匹配項的陣列。

flags

可以是下列旗標的組合（請注意，將 PREG_PATTERN_ORDER 與 PREG_SET_ORDER 一起使用是沒有意義的）

PREG_PATTERN_ORDER

依此排序結果：$matches[0] 是完整模式匹配的陣列，$matches[1] 是由第一個括號中的子模式匹配的字串陣列，依此類推。

<?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";
?>

上述範例會輸出

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

因此，$out[0] 包含一個符合完整模式的字串陣列，而 $out[1] 包含一個由標籤括住的字串陣列。

如果模式包含具名的子模式，$matches 還會包含以子模式名稱作為鍵的項目。

如果模式包含重複的具名子模式，只有最右邊的子模式會儲存在 $matches[NAME] 中。

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

上述範例會輸出

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

PREG_SET_ORDER

依此排序結果：$matches[0] 是第一組匹配項的陣列，$matches[1] 是第二組匹配項的陣列，依此類推。

<?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";
?>

上述範例會輸出

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

PREG_OFFSET_CAPTURE

如果傳遞此旗標，則對於每個發生的匹配項，也會傳回附加的字串偏移量（以位元組為單位）。請注意，這會將 matches 的值變更為陣列的陣列，其中每個元素都是由偏移量 0 處的匹配字串和偏移量 1 處的 subject 中的字串偏移量組成的陣列。

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

上述範例會輸出

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

如果傳遞此旗標，則未匹配的子模式會報告為 null；否則，它們會報告為空 字串。

如果未給定排序旗標，則會假設為 PREG_PATTERN_ORDER。

offset

通常，搜尋會從主旨字串的開頭開始。選擇性參數 offset 可用於指定從其開始搜尋的替代位置（以位元組為單位）。

注意:

使用 offset 不等同於將 substr($subject, $offset) 傳遞給 preg_match_all() 以取代主旨字串，因為 pattern 可能包含斷言，例如 ^、$ 或 (?<=x)。請參閱 preg_match() 以取得範例。