Description:
------------
The code supplied on http://tr.php.net/manual/en/function.preg-match-all.php in Example 2 is erronous,
If the document contains more than one occurences of a tag, than it fails:

$html = '<h1>Heading Largest First</h1><h2>Heading Larger First</h2><a href=howdy.html>click me</a><h1>Heading Largest Second</h1>Some text<h3>Heading Normal</h3>';

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[3] . "\n";
   echo "part 3: " . $val[4] . "\n\n";
}
?>

The ouput is:

matched: <h1>Heading Largest First</h1><h2>Heading Larger First</h2><a href=howdy.html>click me</a><h1>Heading Largest Second</h1>
part 1: <h1>
part 2: Heading Largest First</h1><h2>Heading Larger First</h2><a href=howdy.html>click me</a><h1>Heading Largest Second
part 3: </h1>

matched: <h3>Heading Normal</h3>
part 1: <h3>
part 2: Heading Normal
part 3: </h3>

The reqular expression is missing a question mark, the corrected snippet should be:

$html = '<h1>Heading Largest First</h1><h2>Heading Larger First</h2><a href=howdy.html>click me</a><h1>Heading Largest Second</h1>Some text<h3>Heading Normal</h3>';

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[3] . "\n";
   echo "part 3: " . $val[4] . "\n\n";
}
?>

Then the output will be:

matched: <h1>Heading Largest First</h1>
part 1: <h1>
part 2: Heading Largest First
part 3: </h1>

matched: <h2>Heading Larger First</h2>
part 1: <h2>
part 2: Heading Larger First
part 3: </h2>

matched: <a href=howdy.html>click me</a>
part 1: <a href=howdy.html>
part 2: click me
part 3: </a>

matched: <h1>Heading Largest Second</h1>
part 1: <h1>
part 2: Heading Largest Second
part 3: </h1>

matched: <h3>Heading Normal</h3>
part 1: <h3>
part 2: Heading Normal
part 3: </h3>