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 处的匹配字符串及其在 subject 中的字符串偏移量（在偏移量 1 处）。

<?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()。