int preg_match(string pattern, string subject, array [matches]);pattern で指定した正規表現により subject を検索します。
matches が与えられた場合、検索結果が代入されます。 $matches[0] はパターン全体にマッチしたテキストが代入され、 $matches[1] は最初の括弧付きのサブパターンにマッチしたテキスト が代入され、といったようになります。
文字列 subject にpattern がマッチした場合は true を返し、マッチしなかったか、エラーを発生した場合に false を 返します。
例 1. 文字列からページ番号を得る
if (preg_match("/page\s+#(\d+)/i", "Go to page #9.", $parts))
print "次のページは $parts[1] です。";
else
print "ページが見つかりません。";