PHP preg_match() 函數(shù)用法及示例

PHP 正則表達式(PCRE)

preg_match 函數(shù)用于執(zhí)行一個正則表達式匹配。

語法

int preg_match ( string $pattern , string $subject [, array &$matches [, int $flags = 0 [, int $offset = 0 ]]] )

搜索 subject 與 pattern 給定的正則表達式的一個匹配。

參數(shù)說明：

• $pattern: 要搜索的模式，字符串形式。

• $subject: 輸入字符串。

• $matches: 如果提供了參數(shù)matches，它將被填充為搜索結果。 $matches[0]將包含完整模式匹配到的文本， $matches[1] 將包含第一個捕獲子組匹配到的文本，以此類推。

• $flags：flags 可以被設置為以下標記值：

• PREG_OFFSET_CAPTURE: 如果傳遞了這個標記，對于每一個出現(xiàn)的匹配返回時會附加字符串偏移量(相對于目標字符串的)。 注意：這會改變填充到matches參數(shù)的數(shù)組，使其每個元素成為一個由 第0個元素是匹配到的字符串，第1個元素是該匹配字符串 在目標字符串subject中的偏移量。

• offset: 通常，搜索從目標字符串的開始位置開始?？蛇x參數(shù) offset 用于 指定從目標字符串的某個未知開始搜索(單位是字節(jié))。

返回值

返回 pattern 的匹配次數(shù)。 它的值將是 0 次（不匹配）或 1 次，因為 preg_match() 在第一次匹配后 將會停止搜索。preg_match_all() 不同于此，它會一直搜索subject 直到到達結尾。 如果發(fā)生錯誤preg_match()返回 FALSE。

在線示例

<?php
//模式分隔符后的"i"標記這是一個大小寫不敏感的搜索
if (preg_match("/php/i", "PHP is the web scripting language of choice.")) {
    echo "查找到匹配的字符串 php。";
} else {
    echo "未發(fā)現(xiàn)匹配的字符串 php。";
}
?>

執(zhí)行結果如下所示：

查找到匹配的字符串 php。

<?php
/* 模式中的\b標記一個單詞邊界，所以只有獨立的單詞"web"會被匹配，而不會匹配
 * 單詞的部分內(nèi)容比如"webbing" 或 "cobweb" */
if (preg_match("/\bweb\b/i", "PHP is the web scripting language of choice.")) {
    echo "查找到匹配的字符串。\n";
} else {
    echo "未發(fā)現(xiàn)匹配的字符串。\n";
}
 
if (preg_match("/\bweb\b/i", "PHP is the website scripting language of choice.")) {
    echo "查找到匹配的字符串。\n";
} else {
    echo "未發(fā)現(xiàn)匹配的字符串。\n";
}
?>

執(zhí)行結果如下所示：

查找到匹配的字符串。
未發(fā)現(xiàn)匹配的字符串。

<?php
// 從URL中獲取主機名稱
preg_match('@^(?:http://)?([^/]+)@i',
    "/index.html", $matches);
$host = $matches[1];
 
// 獲取主機名稱的后面兩部分
preg_match('/[^.]+\.[^.]+$/', $host, $matches);
echo "domain name is: {$matches[0]}\n";
?>

執(zhí)行結果如下所示：

domain name is: (cainiaoplus.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);
 
?>

執(zhí)行結果如下所示：

Array
(
    [0] => foobar: 2008
    [name] => foobar
    [1] => foobar
    [digit] => 2008
    [2] => 2008
)

PHP 正則表達式(PCRE)