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

PHP 正則表達(dá)式(PCRE)

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

語(yǔ)法

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

搜索 subject 與 pattern 給定的正則表達(dá)式的一個(gè)匹配。

參數(shù)說(shuō)明：

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

• $subject: 輸入字符串。

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

• $flags：flags 可以被設(shè)置為以下標(biāo)記值：

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

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

返回值

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

在線示例

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

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

查找到匹配的字符串 php。

<?php
/* 模式中的\b標(biāo)記一個(gè)單詞邊界，所以只有獨(dú)立的單詞"web"會(huì)被匹配，而不會(huì)匹配
 * 單詞的部分內(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í)行結(jié)果如下所示：

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

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

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

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í)行結(jié)果如下所示：

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

PHP 正則表達(dá)式(PCRE)