preg_match_all
Perform a global regular expression match
&reftitle.description;
intpreg_match_all
stringpattern
stringsubject
arraymatches
intflags
intoffset
Searches subject for all matches to the regular
expression given in pattern and puts them in
matches in the order specified by
flags.
After the first match is found, the subsequent searches are continued
on from end of the last match.
&reftitle.parameters;
pattern
The pattern to search for, as a string.
subject
The input string.
matches
Array of all matches in multi-dimensional array ordered according to
flags.
flags
Can be a combination of the following flags (note that it doesn't make
sense to use PREG_PATTERN_ORDER together with
PREG_SET_ORDER):
PREG_PATTERN_ORDER
Orders results so that $matches[0] is an array of full
pattern matches, $matches[1] is an array of strings matched by
the first parenthesized subpattern, and so on.
]+>(.*)]+>|U",
"example: this is a test
",
$out, PREG_PATTERN_ORDER);
echo $out[0][0] . ", " . $out[0][1] . "\n";
echo $out[1][0] . ", " . $out[1][1] . "\n";
?>
]]>
&example.outputs;
example: , this is a test
example: , this is a test
]]>
So, $out[0] contains array of strings that matched full pattern,
and $out[1] contains array of strings enclosed by tags.
PREG_SET_ORDER
Orders results so that $matches[0] is an array of first set
of matches, $matches[1] is an array of second set of matches,
and so on.
]+>(.*)]+>|U",
"example: this is a test
",
$out, PREG_SET_ORDER);
echo $out[0][0] . ", " . $out[0][1] . "\n";
echo $out[1][0] . ", " . $out[1][1] . "\n";
?>
]]>
&example.outputs;
example: , example:
this is a test
, this is a test
]]>
PREG_OFFSET_CAPTURE
If this flag is passed, for every occurring match the appendant string
offset will also be returned. Note that this changes the value of
matches in an array where every element is an
array consisting of the matched string at offset 0
and its string offset into subject at offset
1.
If no order flag is given, PREG_PATTERN_ORDER is
assumed.
offset
Normally, the search starts from the beginning of the subject string.
The optional parameter offset can be used to
specify the alternate place from which to start the search (in bytes).
Using offset is not equivalent to passing
substr($subject, $offset) to
preg_match_all in place of the subject string,
because pattern can contain assertions such as
^, $ or
(?<=x). See preg_match
for examples.
&reftitle.returnvalues;
Returns the number of full pattern matches (which might be zero),
or &false; if an error occurred.
&reftitle.changelog;
&Version;
&Description;
4.3.3
The offset parameter was added
4.3.0
The PREG_OFFSET_CAPTURE flag was added
&reftitle.examples;
Getting all phone numbers out of some text.
]]>
Find matching HTML tags (greedy)
bold textclick me";
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";
}
?>
]]>
&example.outputs;
bold text
part 1:
part 2: b
part 3: bold text
part 4:
matched: click me
part 1:
part 2: a
part 3: click me
part 4:
]]>
Using named subpattern
\w+): (?\d+)/', $str, $matches);
print_r($matches);
?>
]]>
&example.outputs;
Array
(
[0] => a: 1
[1] => b: 2
[2] => c: 3
)
[name] => Array
(
[0] => a
[1] => b
[2] => c
)
[1] => Array
(
[0] => a
[1] => b
[2] => c
)
[digit] => Array
(
[0] => 1
[1] => 2
[2] => 3
)
[2] => Array
(
[0] => 1
[1] => 2
[2] => 3
)
)
]]>
&reftitle.seealso;
preg_match
preg_replace
preg_split