preg_match()函数—用法及示例

函数名称：preg_match()

函数适用版本：PHP 4, PHP 5, PHP 7

函数用法：preg_match() 函数用于在字符串中搜索匹配正则表达式的内容。

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

参数：

• $pattern：正则表达式模式，用于匹配字符串。
• $subject：要搜索的字符串。
• $matches（可选）：如果提供了该参数，将被填充为搜索结果的匹配项。
• $flags（可选）：可选标志参数，用于修改搜索行为。常用的标志有：
  • PREG_OFFSET_CAPTURE：将匹配项的偏移量包含在返回的匹配数组中。
  • PREG_UNMATCHED_AS_NULL：将未匹配的子模式设置为 NULL。
• $offset（可选）：开始搜索的偏移量。

返回值：如果匹配成功，则返回 1，否则返回 0。

示例：

$pattern = '/[0-9]+/';
$subject = 'There are 123 apples.';
$matches = array();

if (preg_match($pattern, $subject, $matches)) {
    echo '匹配成功！';
    echo '匹配的数字是：' . $matches[0];
} else {
    echo '匹配失败！';
}

输出：

匹配成功！
匹配的数字是：123

在上述示例中，我们使用了 preg_match() 函数来搜索字符串中的数字。正则表达式模式 /[0-9]+/ 表示匹配一个或多个数字。如果匹配成功，则将匹配的数字存储在 $matches 数组中，并输出匹配的结果。

注意：preg_match() 函数只返回第一个匹配项，如果需要查找所有匹配项，可以使用 preg_match_all() 函数。