preg_match 执行匹配正则表达式
发表日期:2021-07-01 08:56:55 | 来源: | | 浏览(540) 分类:PCRE 函数
preg_match
(PHP 4, PHP 5, PHP 7, PHP 8)
preg_match — 执行匹配正则表达式
说明
string
$pattern
,string
$subject
,array
&$matches
= null
,int
$flags
= 0,int
$offset
= 0): int|false
搜索subject
与pattern
给定的正则表达式的一个匹配.
参数
-
pattern
-
要搜索的模式,字符串类型。
-
subject
-
输入字符串。
-
matches
-
如果提供了参数
matches
,它将被填充为搜索结果。 $matches[0]将包含完整模式匹配到的文本, $matches[1] 将包含第一个捕获子组匹配到的文本,以此类推。 -
flags
-
flags
可以被设置为以下标记值的组合:-
PREG_OFFSET_CAPTURE
-
如果传递了这个标记,对于每一个出现的匹配返回时会附加字符串偏移量(相对于目标字符串的字节数)。 注意:这会改变填充到
matches
参数的数组,使其每个元素成为一个由 第0
个元素是匹配到的字符串,第1
个元素是该匹配字符串 在目标字符串subject
中的偏移量。1
<?php
2
preg_match(
'/(foo)(bar)(baz)/'
,
'foobarbaz'
,
$matches
, PREG_OFFSET_CAPTURE);
3
print_r(
$matches
);
4
?>
以上例程会输出:
Array ( [0] => Array ( [0] => foobarbaz [1] => 0 ) [1] => Array ( [0] => foo [1] => 0 ) [2] => Array ( [0] => bar [1] => 3 ) [3] => Array ( [0] => baz [1] => 6 ) )
-
PREG_UNMATCHED_AS_NULL
-
使用该标记,未匹配的子组会报告为
null
;未使用时,报告为空的 string。1
<?php
2
preg_match(
'/(a)(b)*(c)/'
,
'ac'
,
$matches
);
3
var_dump(
$matches
);
4
preg_match(
'/(a)(b)*(c)/'
,
'ac'
,
$matches
, PREG_UNMATCHED_AS_NULL);
5
var_dump(
$matches
);
6
?>
以上例程会输出:
array(4) { [0]=> string(2) "ac" [1]=> string(1) "a" [2]=> string(0) "" [3]=> string(1) "c" } array(4) { [0]=> string(2) "ac" [1]=> string(1) "a" [2]=> NULL [3]=> string(1) "c" }
-
-
offset
-
通常,搜索从目标字符串的开始位置开始。可选参数
offset
用于 指定从目标字符串的某个位置开始搜索(单位是字节)。注意:
使用
offset
参数不同于向preg_match() 传递按照位置通过substr($subject, $offset)
截取目标字符串结果, 因为pattern
可以包含断言比如^, $ 或者(?<=x)。 比较:1
<?php
2
$subject
=
"abcdef"
;
3
$pattern
=
'/^def/'
;
4
preg_match(
$pattern
,
$subject
,
$matches
, PREG_OFFSET_CAPTURE, 3);
5
print_r(
$matches
);
6
?>
以上例程会输出:
Array ( )
当这个示例使用截取后传递时
1
<?php
2
$subject
=
"abcdef"
;
3
$pattern
=
'/^def/'
;
4
preg_match(
$pattern
,
substr
(
$subject
,3),
$matches
, PREG_OFFSET_CAPTURE);
5
print_r(
$matches
);
6
?>
将会产生匹配
Array ( [0] => Array ( [0] => def [1] => 0 ) )
要避免使用 substr(),可以用
\G
断言而不是^
锚,或者A
修改器,它们都能和offset
参数一起运行。
返回值
preg_match()返回 pattern
的匹配次数。
它的值将是0次(不匹配)或1次,因为preg_match()在第一次匹配后
将会停止搜索。preg_match_all()不同于此,它会一直搜索subject
直到到达结尾。
如果发生错误preg_match()返回 false
。
更新日志
版本 | 说明 |
---|---|
7.2.0 |
现在 $flags 参数支持 PREG_UNMATCHED_AS_NULL 。
|
范例
示例 #1 查找文本字符串"php"
1 | <?php |
2 | //模式分隔符后的"i"标记这是一个大小写不敏感的搜索if (preg_match("/php/i", "PHP is the web scripting language of choice.")) { |
3 | echo "A match was found." ; |
4 | } |
5 | else { |
6 | echo "A match was not found." ; |
7 | } |
8 | ?> |
示例 #2 查找单词"word"
01 | <?php |
02 | /* 模式中的\b标记一个单词边界,所以只有独立的单词"web"会被匹配,而不会匹配 * 单词的部分内容比如"webbing" 或 "cobweb" */ |
03 | if (preg_match( "/\bweb\b/i" , "PHP is the web scripting language of choice." )) { |
04 | echo "A match was found." ; |
05 | } |
06 | else { |
07 | echo "A match was not found." ; |
08 | } |
09 | if (preg_match( "/\bweb\b/i" , "PHP is the website scripting language of choice." )) { |
10 | echo "A match was found." ; |
11 | } |
12 | else { |
13 | echo "A match was not found." ; |
14 | } |
15 | ?> |
示例 #3 获取URL中的域名
1 | <?php |
2 | //从URL中获取主机名称preg_match('@^(?:http://)?([^/]+)@i', "http://www.php.net/index.html", $matches); |
3 | $host = $matches [1]; |
4 | //获取主机名称的后面两部分preg_match('/[^.]+\.[^.]+$/', $host, $matches); |
5 | echo "domain name is: { |
6 | $matches [0]} |
7 | \n"; |
8 | ?> |
以上例程会输出:
domain name is: php.net
示例 #4 使用命名子组
1 | <?php |
2 | $str = 'foobar: 2008' ; |
3 | preg_match( '/(?P<name>\w+): (?P<digit>\d+)/' , $str , $matches ); |
4 | /* 可选的方式 */ |
5 | // preg_match('/(?<name>\w+): (?<digit>\d+)/', $str, $matches); |
6 | print_r( $matches ); |
7 | ?> |
以上例程会输出:
Array ( [0] => foobar: 2008 [name] => foobar [1] => foobar [digit] => 2008 [2] => 2008 )
注释
如果你仅仅想要检查某个字符串是否包含另外一个字符串,不要使用preg_match()。 使用 strpos() 会更快。
参见
- PCRE 模式
- preg_quote() - 转义正则表达式字符
- preg_match_all() - 执行一个全局正则表达式匹配
- preg_replace() - 执行一个正则表达式的搜索和替换
- preg_split() - 通过一个正则表达式分隔字符串
- preg_last_error() - 返回最后一个PCRE正则执行产生的错误代码
- preg_last_error_msg() - Returns the error message of the last PCRE regex execution
- PHP(0)
- PHP杂项(34)
- PHP基础-李炎恢系列课程(20)
- 中文函数手册(0)
- 错误处理 函数(13)
- OPcache 函数(6)
- PHP 选项/信息 函数(54)
- Zip 函数(10)
- Hash 函数(15)
- OpenSSL 函数(63)
- Date/Time 函数(51)
- 目录函数(9)
- Fileinfo 函数(6)
- iconv 函数(11)
- 文件系统函数(81)
- 多字节字符串 函数(57)
- GD 和图像处理 函数(114)
- 可交换图像信息(5)
- Math 函数(50)
- 程序执行函数(11)
- PCNTL 函数(23)
- JSON 函数(4)
- SPL 函数(15)
- URL 函数(10)
- cURL 函数(32)
- 网络 函数(33)
- FTP 函数(36)
- Session 函数(23)
- PCRE 函数(11)
- preg_filter 执行一个正则表达式搜索和替换(0)
- preg_grep 返回匹配模式的数组条目(0)
- preg_last_error_msg Returns the error message of the last PCRE regex execution(0)
- preg_last_error 返回最后一个PCRE正则执行产生的错误代码(0)
- preg_match_all 执行一个全局正则表达式匹配(0)
- preg_match 执行匹配正则表达式(0)
- preg_quote 转义正则表达式字符(0)
- preg_replace_callback_array Perform a regular expression search and replace using callbacks(0)
- preg_replace_callback 执行一个正则表达式搜索并且使用一个回调进行替换(0)
- preg_replace 执行一个正则表达式的搜索和替换(0)
- preg_split 通过一个正则表达式分隔字符串(0)
- PCRE 正则语法(19)
- 数组 函数(81)
- 类/对象 函数(18)
- 函数处理 函数(13)
- 变量处理 函数(37)
- SimpleXML 函数(3)
- 杂项 函数(31)
- 字符串 函数(101)