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.
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):
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.
?php preg_match_all ("| [^ ]+ (.*) /[^ ]+ |U", " b example: /b div align=left this is a test /div ", $out, PREG_PATTERN_ORDER); print $out[0][0].", ".$out[0][1]."\n"; print $out[1][0].", ".$out[1][1]."\n"; ? |
This example will produce:
b example: /b , div align=left this is a test /div example: , this is a test |
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.
?php preg_match_all ("| [^ ]+ (.*) /[^ ]+ |U", " b example: /b div align=left this is a test /div ", $out, PREG_SET_ORDER); print $out[0][0].", ".$out[0][1]."\n"; print $out[1][0].", ".$out[1][1]."\n"; ? |
If this flag is set, for every occuring match the
appendant string offset will also be returned. Note
that this changes the return value in an array where
every element is an array consisting of the matched
string at offset 0 and it's
string offset into
subject at offset 1.
This flag is available since
PHP 4.3.0 .
If no order flag is given,
PREG_PATTERN_ORDER is assumed.
Returns the number of full pattern matches (which might
be zero), or FALSE if an
error occurred.
matched: b bold text /b part 1: b part 2: bold text part 3: /b matched: a href=howdy.html click me /a part 1: a href=howdy.html part 2: click me part 3: /a |
See also preg_match(),
preg_replace(), and
preg_split().