preg_match_all：PHPマニュアル

PHP マニュアル
前のページ		次のページ

説明

int preg_match_all ( string pattern, string subject, array &matches [, int flags [, int offset]] )

subject を検索し、 pattern に指定した正規表現にマッチしたすべての文字列を、flags で指定した順番で、matches に代入します。

正規表現にマッチすると、そのマッチした文字列の後から検索が続行されます。

flagsは、以下のフラグの組み合わせとなります。 (PREG_PATTERN_ORDER を PREG_SET_ORDER と組み合わせて使用することは無意味ですので注意してください。)

PREG_PATTERN_ORDER

$matches[0] はパターン全体にマッチした文字列の配列、 $matches[1] は第 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]は、タグで囲まれた文字列の配列を有しています。

PREG_SET_ORDER

$matches[0]は 1 回目のマッチングでキャプチャした値の配列、 $matches[1]は 2 回目のマッチングでキャプチャした値の配列、といった順序となります。


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

この場合、$matches[0] は 1 回目のマッチングによるもので、 $matches[0][0] はパターン全体にマッチしたテキスト、 $matches[0][1] は第 1 のサブパターンにマッチしたテキスト、といったようになります。同様に、$matches[1]は 2 回目のマッチングによるものといったようになります。

PREG_OFFSET_CAPTURE

このフラグを設定した場合、各マッチに対応する文字列のオフセットも返されます。これにより、返り値は配列となり、配列の要素 0 はマッチした文字列、要素 1 は subject におけるマッチした文字列のオフセット値となることに注意してください。このフラグは、PHP 4.3.0 以降で利用可能です。

flags を指定しない場合は、 PREG_PATTERN_ORDER が指定されたことになります。

通常、検索は対象文字列の先頭から開始されます。オプションのパラメータ offset を使用して検索の開始位置を指定することも可能です。 offsetパラメータは、PHP 4.3.3 以降で使用できます。

注意: offset を用いるのと、 substr($subject, $offset) を preg_match_all()の対象文字列として指定するのとは等価ではありません。これは、pattern には、 ^, $ や (?<=x) のような言明を含めることができるためです。これに関する例については、 preg_match() を参照してください。

パターンがマッチした総数を返します（ゼロとなる可能性もあります）。または、エラーが発生した場合に FALSE を返します。

例 1. テキストからすべての電話番号を得る
<?php preg_match_all("/$? (\d{3})? $? (?(1) [\-\s] ) \d{3}-\d{4}/x", "Call 555-1212 or 1-800-555-1212", $phones); ?>

例 2. HTML タグにマッチするものを見付ける（貪欲）
<?php // \\2 は後方参照の例。これは、pcre に正規表現中の括弧の 2 番目の // 組、つまりこの場合は ([\w]+)、にマッチする。文字列が二重引用符で // 括られているため、バックスラッシュの追加が必要。 $html = "bold text<a href=howdy.html>click me</a>"; preg_match_all("/(<([\w]+)[^>]*>)(.*)(<\/\\2>)/", $html, $matches); for ($i=0; $i< count($matches[0]); $i++) { echo "matched: " . $matches[0][$i] . "\n"; echo "part 1: " . $matches[1][$i] . "\n"; echo "part 2: " . $matches[3][$i] . "\n"; echo "part 3: " . $matches[4][$i] . "\n\n"; } ?>
この例の出力は以下となります。
matched: bold text part 1: part 2: bold text part 3: matched: <a href=howdy.html>click me</a> part 1: <a href=howdy.html> part 2: click me part 3: </a>

preg_match(), preg_replace() および preg_split() も参照してください。

前のページ	ホーム	次のページ
preg_grep	上に戻る	preg_match