PHP preg_match() 関数

PHP 正規表現(PCRE)

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 には以下のフラグ値を設定できます:

    1. PREG_OFFSET_CAPTURE: このフラグを渡すと、各マッチの結果に文字列オフセット(対象文字列に対する)が追加されます。注意:これにより matches パラメータに格納される配列が変更され、各要素は「0番目の要素がマッチした文字列、1番目の要素が対象文字列 subject 内でのそのマッチ文字列のオフセット」という形になります。

  • offset: 通常、検索は対象文字列の先頭位置から始まります。オプションのパラメータ offset は、対象文字列の任意の位置から検索を開始するために使用されます(単位はバイト)。

戻り値

pattern のマッチ回数を返します。preg_match() は最初のマッチで検索を停止するため、その値は 0 回(不一致)または 1 回になります。preg_match_all() はこれとは異なり、末尾に達するまで subject を検索し続けます。エラーが発生した場合、preg_match() は FALSE を返します。

例

テキスト文字列 "php" を検索します:

<?php //パターン区切り文字の後の "i" は、大文字小文字を区別しない検索であることを示します。 if (preg_match("/php/i", "PHP is the web scripting language of choice.")) { echo "マッチした文字列 php が見つかりました。"; } else { echo "マッチする文字列 php は見つかりませんでした。"; } ?>

実行結果は以下の通りです:

查找到匹配的字符串 php。


単語 "web" を検索

<?php /*パターン内の \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 からドメイン名を取得する

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


名前付きサブグループを使用する

<?php $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
)

PHP 正規表現(PCRE)

他の拡張