PHP preg_match() 関数
preg_match 関数は、正規表現マッチングを実行するために使用されます。
構文
int preg_match ( string $pattern , string $subject [, array &$matches [, int $flags = 0 [, int $offset = 0 ]]] )
subject 内で pattern で指定された正規表現のマッチングを検索します。
パラメータの説明:
$pattern: 検索するパターン。文字列形式です。
$subject: 入力文字列。
$matches: 引数 matches が指定された場合、検索結果が格納されます。$matches
$flags: flags には以下のフラグ値を設定できます:
PREG_OFFSET_CAPTURE: このフラグを渡すと、各マッチの結果に文字列オフセット(対象文字列に対する)が追加されます。注意:これにより matches パラメータに格納される配列が変更され、各要素は「0番目の要素がマッチした文字列、1番目の要素が対象文字列 subject 内でのそのマッチ文字列のオフセット」という形になります。
offset: 通常、検索は対象文字列の先頭位置から始まります。オプションのパラメータ offset は、対象文字列の任意の位置から検索を開始するために使用されます(単位はバイト)。
戻り値
pattern のマッチ回数を返します。preg_match() は最初のマッチで検索を停止するため、その値は 0 回(不一致)または 1 回になります。preg_match_all() はこれとは異なり、末尾に達するまで subject を検索し続けます。エラーが発生した場合、preg_match() は FALSE を返します。
例
テキスト文字列 "php" を検索します:
//パターン区切り文字の後の "i" は、大文字小文字を区別しない検索であることを示します。
if (preg_match("/php/i", "PHP is the web scripting language of choice.")) {
echo "マッチした文字列 php が見つかりました。";
} else {
echo "マッチする文字列 php は見つかりませんでした。";
}
実行結果は以下の通りです:
查找到匹配的字符串 php。
単語 "web" を検索
/*パターン内の \b は単語境界を示すため、独立した単語 "web" のみがマッチし、
* "webbing" や "cobweb" のような単語の一部にはマッチしません。*/
if (preg_match("/\bweb\b/i", "PHP is the web scripting language of choice.")) {
echo "マッチした文字列が見つかりました。\n";
} else {
echo "マッチする文字列は見つかりませんでした。\n";
}
if (preg_match("/\bweb\b/i", "PHP is the website scripting language of choice.")) {
echo "マッチした文字列が見つかりました。\n";
} else {
echo "マッチする文字列は見つかりませんでした。\n";
}
実行結果は以下の通りです:
一致する文字列が見つかりました。 一致する文字列は見つかりませんでした。
URL からドメイン名を取得する
//URL からホスト名を取得する
preg_match('@^(?:http://)?([^/]+)@i',
"http://www.example.com/index.html", $matches);
$host = $matches[1];
//ホスト名の後ろの2つの部分を取得する
preg_match('/[^.]+\.[^.]+$/', $host, $matches);
echo "domain name is: {$matches[0]}\n";
実行結果は以下の通りです:
domain name is: example.com
名前付きサブグループを使用する
$str = 'foobar: 2008';
preg_match('/(?P<name>\w+): (?P<digit>\d+)/', $str, $matches);
/*以下の例は php 5.2.2 (pcre 7.0) 以降で動作します。ただし、後方互換性のため、上記の方法が推奨されます。*/
// preg_match('/(?<name>\w+): (?<digit>\d+)/', $str, $matches);
print_r($matches);
実行結果は以下の通りです:
Array
(
[0] => foobar: 2008
[name] => foobar
[1] => foobar
[digit] => 2008
[2] => 2008
)
他の拡張