选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0
历史版本PostgreSQL 9.5 已于 2021 年 2 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本

9.7. 模式匹配 #

PostgreSQL提供了三种独立的模式匹配方法:传统的SQL LIKE操作符、较新的SIMILAR TO操作符(在 SQL:1999 中加入),以及POSIX风格的正则表达式。除了用于判断这个字符串是否匹配这个模式?的基本操作符外,还提供了提取或替换匹配子字符串、在匹配位置分割字符串的函数。

提示

如果你的模式匹配的要求超出了这些,请考虑用 Perl 或 Tcl 写一个用户定义的函数。

小心

虽然大多数正则表达式搜索都能很快完成,但特意构造的正则表达式可能需要任意长的处理时间和任意多的内存。接受来自恶意来源的正则表达式搜索模式时应当谨慎。如果必须这样做,建议设置语句超时。

使用SIMILAR TO模式进行搜索具有同样的安全风险,因为SIMILAR TO提供了许多与POSIX风格正则表达式相同的能力。

LIKE搜索比另外两种方法简单得多,因此,当模式可能来自恶意来源时,使用它更安全。

9.7.1. LIKE #

string LIKE pattern [ESCAPE escape-character]
string NOT LIKE pattern [ESCAPE escape-character]

如果该string匹配了提供的pattern,那么LIKE表达式返回真(和预期的一样,如果LIKE返回真,那么NOT LIKE表达式返回假, 反之亦然。一个等效的表达式是NOT (string LIKE pattern))。

如果pattern不包含百分号或下划线,那么该模式只表示它 本身的字符串;在这种情况下,LIKE的行为就像等号操作符。 pattern中的下划线(_)代表 (匹配)任意单个字符;百分号(%)匹配任意由零个或多个 字符组成的序列。

一些示例:

'abc' LIKE 'abc'    true
'abc' LIKE 'a%'     true
'abc' LIKE '_b_'    true
'abc' LIKE 'c'      false

LIKE模式匹配总是覆盖整个字符串。因此,如果想要匹配字符串内 任意位置上的一个序列,该模式就必须以百分号开头并以百分号结尾。

要匹配字面量下划线或百分号而不是把它们当作通配符, pattern中相应的字符前面必须带有转义字符。 默认的转义字符是反斜线,但也可以使用ESCAPE子句选择其他 转义字符。要匹配转义字符本身,请写两个转义字符。

注意

如果你关掉了standard_conforming_strings,你在字符串常量中写的任何反斜线都需要被双写。详见第 4.1.2.1 节

也可以通过写 ESCAPE '' 来选择不使用转义字符。这会禁用转义机制,从而无法关闭模式中下划线和百分号的特殊含义。

可以用关键字 ILIKE 代替 LIKE,使匹配根据当前区域设置忽略大小写。这不属于 SQL 标准,而是 PostgreSQL 的扩展。

操作符~~等效于LIKE, 而~~*对应ILIKE。 还有 !~~!~~*操作符分别代表NOT LIKENOT ILIKE。 所有这些操作符都是PostgreSQL特有的。 你可能会在EXPLAIN输出和类似的地方看到这些操作符名称,因为解析器实际上将LIKE等翻译成这些操作符。

PostgreSQL 语法中,LIKEILIKENOT LIKENOT ILIKE 通常被当作操作符;例如,它们可以用于 expression operator ANY (subquery) 构造,但其中不能包含 ESCAPE 子句。在某些不常见的情况下,可能需要改用底层操作符名称。

9.7.2. SIMILAR TO正则表达式 #

string SIMILAR TO pattern [ESCAPE escape-character]
string NOT SIMILAR TO pattern [ESCAPE escape-character]

SIMILAR TO 操作符根据其模式是否匹配给定字符串返回真或假。它与 LIKE 类似,但按照 SQL 标准定义的正则表达式来解释模式。SQL 正则表达式是 LIKE 表示法和常见正则表达式表示法的一种奇特结合。

LIKE类似,SIMILAR TO操作符只有在其模式匹配整个字符串时才算成功;这一点不同于普通正则表达式,后者可以匹配字符串的任意部分。与LIKE相同,SIMILAR TO也使用_%作为通配符,分别匹配任意单个字符和任意字符串(分别类似于 POSIX 正则表达式中的..*)。

除了这些从LIKE借用的功能之外,SIMILAR TO支持下面这些从 POSIX 正则表达式借用的 模式匹配元字符:

  • |表示选择(两个候选之一)。

  • *表示重复前面的项零次或更多次。

  • +表示重复前面的项一次或更多次。

  • ?表示重复前面的项零次或一次。

  • {m}表示重复前面的项刚好m次。

  • {m,}表示重复前面的项m次或更多次。

  • {m,n}表示重复前面的项至少m次并且不超过n次。

  • 可以使用圆括号()把多个项组合成一个逻辑项。

  • 一个方括号表达式[...]声明一个字符类,就像 POSIX 正则表达式一样。

注意点号(.)不是SIMILAR TO的一个元字符。

LIKE 一样,反斜杠会禁用这些元字符的特殊含义;也可以用 ESCAPE 指定其他转义字符。

下面是一些示例:

'abc' SIMILAR TO 'abc'      true
'abc' SIMILAR TO 'a'        false
'abc' SIMILAR TO '%(b|d)%'  true
'abc' SIMILAR TO '(b|c)%'   false

带三个参数的 substring 函数,即 substring(string from pattern for escape-character),用于提取匹配 SQL 正则表达式模式的子串。与 SIMILAR TO 一样,指定模式必须匹配整个数据字符串,否则函数失败并返回空值。要指出成功时应返回的模式部分,模式中必须出现两次后跟双引号(")的转义字符。函数返回匹配这两个标记之间的模式部分的文本。

下面是一些示例,其中使用#"界定返回字符串:

substring('foobar' from '%#"o_b#"%' for '#')   oob
substring('foobar' from '#"o_b#"%' for '#')    NULL

9.7.3. POSIX正则表达式 #

表 9.12列出了所有可用于 POSIX 正则表达式模式匹配的操作符。

表 9.12. 正则表达式匹配操作符

操作符 描述 示例
~ 匹配正则表达式,区分大小写 'thomas' ~ '.*thomas.*'
~* 匹配正则表达式,不区分大小写 'thomas' ~* '.*Thomas.*'
!~ 不匹配正则表达式,区分大小写 'thomas' !~ '.*Thomas.*'
!~* 不匹配正则表达式,不区分大小写 'thomas' !~* '.*vadim.*'

POSIX正则表达式提供了比LIKESIMILAR TO操作符更强大的模式匹配方式。许多 Unix 工具,例如egrepsedawk,都使用与这里描述的模式匹配语言相似的语言。

正则表达式是一个字符序列,是定义一组字符串(一个正则集)的简写。如果字符串属于正则表达式描述的正则集,就称该字符串匹配此正则表达式。与LIKE一样,模式中的字符精确匹配字符串中的字符,除非该模式字符在正则表达式语言中有特殊含义 — 但正则表达式使用的特殊字符与LIKE不同。与LIKE模式不同,正则表达式可以匹配字符串中的任意位置,除非显式将其锚定到字符串开头或末尾。

下面是一些示例:

'abc' ~ 'abc'    true
'abc' ~ '^a'     true
'abc' ~ '(b|d)'  true
'abc' ~ '^(b|c)' false

POSIX模式语言的详细描述见下文。

带两个参数的 substring 函数,即 substring(string from pattern),用于提取匹配 POSIX 正则表达式模式的子串。如果没有匹配,它返回空值;否则返回匹配模式的那部分文本。但是,如果模式包含圆括号,则返回匹配第一个括号子表达式(左圆括号最先出现的那个)的文本。如果要在表达式内部使用圆括号而不触发这个例外,可以在整个表达式外再加一对圆括号。如果需要在想要提取的子表达式之前使用圆括号,请参见下文介绍的非捕获圆括号。

下面是一些示例:

substring('foobar' from 'o.b')     oob
substring('foobar' from 'o(.)b')   o

regexp_replace函数用新文本替换匹配 POSIX 正则表达式模式的子字符串。它的语法为 regexp_replace(source, pattern, replacement [, flags ])。如果没有与 pattern 匹配的内容,则原样返回 source 字符串。如果存在匹配,则返回将匹配子字符串替换为 replacement 字符串后的 source 字符串。replacement 字符串可以包含 \n,其中 n 为 1 至 9,表示应插入与模式中第 n 个圆括号子表达式匹配的源子字符串;它也可以包含 \&,表示应插入与整个模式匹配的子字符串。如果需要在替换文本中放置字面的反斜杠,应写成 \\flags 参数是可选的文本字符串,其中包含零个或多个改变函数行为的单字母标志。标志 i 指定不区分大小写的匹配,而标志 g 指定替换每个匹配的子字符串,而不仅是第一个。支持的标志(不包括 g)在表 9.20中描述。

下面是一些示例:

regexp_replace('foobarbaz', 'b..', 'X')
                                   fooXbaz
regexp_replace('foobarbaz', 'b..', 'X', 'g')
                                   fooXX
regexp_replace('foobarbaz', 'b(..)', 'X\1Y', 'g')
                                   fooXarYXazY

regexp_matches函数返回一个文本数组,其中包含与 POSIX 正则表达式模式匹配所得到的所有捕获子串。它的语法为 regexp_matches(string, pattern [, flags ])。 该函数可以不返回行、返回一行或多行(见下面的g标志)。如果pattern不匹配,该函数不返回任何行。如果模式不包含圆括号子表达式,则返回的每一行都是包含与整个模式匹配的子字符串的单元素文本数组。如果模式包含圆括号子表达式,该函数返回一个文本数组,其中第n个元素是匹配模式的第n个圆括号子表达式的子字符串(不包括非捕获括号;详情见下文)。 flags参数是一个可选的文本字符串,其中包含零个或多个单个字母标志,用于更改函数的行为。标志g使该函数查找字符串中的每个匹配项,而不仅仅是第一个,并为每个这样的匹配返回一行。支持的标志(但不包括g)在表 9.20中描述。

下面是一些示例:

SELECT regexp_matches('foobarbequebaz', '(bar)(beque)');
 regexp_matches 
----------------
 {bar,beque}
(1 row)

SELECT regexp_matches('foobarbequebazilbarfbonk', '(b[^b]+)(b[^b]+)', 'g');
 regexp_matches 
----------------
 {bar,beque}
 {bazil,barf}
(2 rows)

SELECT regexp_matches('foobarbequebaz', 'barbeque');
 regexp_matches 
----------------
 {barbeque}
(1 row)

可以通过使用子查询强制regexp_matches()总是返回一行;当希望返回所有行(包括不匹配的行)时,这在SELECT目标列表中特别有用:

SELECT col1, (SELECT regexp_matches(col2, '(bar)(beque)')) FROM tab;

regexp_split_to_table把一个 POSIX 正则表达式模式当作一个定界符来分割字符串。它的语法形式是regexp_split_to_table(string, pattern [, flags ])。如果没有与pattern的匹配,该函数返回string。如果至少有一个匹配,对每一个匹配它都返回从上一个匹配的末尾(或者串的开头)到这次匹配开头之间的文本。当没有更多匹配时,它返回从上一次匹配的末尾到串末尾之间的文本。flags参数是一个可选的文本串,它包含零个或更多单字母标志,这些标志可以改变该函数的行为。regexp_split_to_table能支持的标志在表 9.20中描述。

regexp_split_to_array函数的行为和regexp_split_to_table相同,不过regexp_split_to_array会把它的结果以一个text数组的形式返回。它的语法是regexp_split_to_array(string, pattern [, flags ])。这些参数和regexp_split_to_table的相同。

下面是一些示例:

SELECT foo FROM regexp_split_to_table('the quick brown fox jumps over the lazy dog', '\s+') AS foo;
  foo   
-------
 the    
 quick  
 brown  
 fox    
 jumps 
 over   
 the    
 lazy   
 dog    
(9 rows)

SELECT regexp_split_to_array('the quick brown fox jumps over the lazy dog', '\s+');
              regexp_split_to_array             
-----------------------------------------------
 {the,quick,brown,fox,jumps,over,the,lazy,dog}
(1 row)

SELECT foo FROM regexp_split_to_table('the quick brown fox', '\s*') AS foo;
 foo 
-----
 t         
 h         
 e         
 q         
 u         
 i         
 c         
 k         
 b         
 r         
 o         
 w         
 n         
 f         
 o         
 x         
(16 rows)

正如最后一个示例所示,正则表达式分割函数会忽略出现在字符串开头或结尾 或紧跟在前一个匹配项之后的零长度匹配。这与regexp_matches实现的 严格的正则表达式匹配定义相矛盾,但在实践中通常是最方便的行为。 其他软件系统如Perl使用类似的定义。

9.7.3.1. 正则表达式细节 #

PostgreSQL的正则表达式是使用 Henry Spencer 写的一个包来实现的。下面的正则表达式的大部分描述都是从他的手册页中逐字拷贝过来的。

正则表达式(RE),在POSIX 1003.2 中定义, 它有两种形式:扩展RE或者是ERE(大概地说就是那些在egrep里的), 基本RE或者是BRE(大概地说就是那些在ed里的)。PostgreSQL支持两种形式,并且还实现了一些POSIX标准中没有但是在类似 Perl 或者 Tcl 这样的语言中得到广泛应用的一些扩展。使用了那些非POSIX扩展的RE高级RE, 或者本文档里说的ARE。ARE 几乎完全是 ERE 的超集,但是 BRE 有几个符号上的不兼容(以及更多的限制)。我们首先描述 ARE 和 ERE 形式, 描述那些只适用于 ARE 的特性,然后描述 BRE 的区别是什么。

注意

PostgreSQL最初总是假定正则表达式遵循 ARE 规则。不过,也可以像第 9.7.3.4 节中所述那样,在 RE 模式前加上一个嵌入选项,从而改用限制更多的 ERE 或 BRE 规则。这对于需要精确遵循POSIX 1003.2 规则的应用有助于保持兼容性。

一个正则表达式被定义为一个或更多分支,它们之间被|分隔。只要能匹配其中一个分支的东西都能匹配正则表达式。

一个分支是零个或多个量化原子约束,连接在一起。 它匹配第一个的匹配项,然后是第二个的匹配项,依此类推;一个空分支匹配空字符串。

一个量化原子是一个原子,后面可以跟一个量词。没有量词时,匹配一次原子所匹配的内容;有量词时,按量词指定的次数匹配原子所匹配的内容。原子可以是表 9.13列出的任何一种形式。可用量词及其含义见表 9.14

一个约束匹配一个空串,但只是在满足特定条件下才匹配。 约束可以在能够使用原子的地方使用,只是它不能跟着量词。简单的约束在表 9.15里显示; 更多的约束稍后描述。

表 9.13. 正则表达式原子

原子 描述
(re) (其中re是任意正则表达式)匹配re所匹配的内容,并记录该匹配,以备输出结果
(?:re) 同上,但不记录匹配结果(非捕获圆括号;仅适用于 ARE)
. 匹配任意单个字符
[chars] 一个方括号表达式, 匹配chars中的任意一个(详见第 9.7.3.2 节
\k (其中k既不是字母也不是数字)把该字符视为普通字符并匹配它,例如,\\匹配反斜线字符
\c 其中c是字母或数字(后面可能还有其他字符),这是一个转义,参见第 9.7.3.3 节(仅适用于 ARE;在 ERE 和 BRE 中,它匹配c
{ 如果后面跟着非数字字符,则匹配左花括号{;如果后面跟着数字,则是bound的开头(见下文)
x 其中x是一个没有其它意义的单个字符,则匹配该字符

RE 不能以反斜线(\)结尾。

注意

如果你关掉了standard_conforming_strings,你在字符串常量中写的任何反斜线都需要被双写。详见第 4.1.2.1 节

表 9.14. 正则表达式量词

量词 匹配
* 一个由原子的 0 次或更多次匹配组成的序列
+ 一个由原子的 1 次或更多次匹配组成的序列
? 一个由原子的 0 次或 1 次匹配组成的序列
{m} 一个由原子的正好m次匹配组成的序列
{m,} 一个由原子的m次或更多次匹配组成的序列
{m,n} 一个由原子的从m次到n次(包括)匹配组成的序列;m不能超过n
*? *的非贪婪版本
+? +的非贪婪版本
?? ?的非贪婪版本
{m}? {m}的非贪婪版本
{m,}? {m,}的非贪婪版本
{m,n}? {m,n}的非贪婪版本

使用{...}的形式被称作范围。 一个范围内的数字mn都是无符号十进制整数, 允许的数值从 0 到 255(包含)。

非贪婪量词(仅适用于 ARE)与对应的普通(贪婪)量词匹配相同的可能内容,但优先选择最少的匹配次数,而不是最多的匹配次数。详见第 9.7.3.5 节

注意

一个量词不能紧跟在另外一个量词后面,例如**是非法的。量词不能作为表达式或者子表达式的开头,也不能跟在^或者|后面。

表 9.15. 正则表达式约束

约束 描述
^ 在字符串开头匹配
$ 在字符串末尾匹配
(?=re) 正向先行断言在这样的位置匹配:存在从该位置开始且匹配re的子字符串(仅适用于 ARE)
(?!re) 负向先行断言在这样的位置匹配:不存在任何从该位置开始且匹配re的子字符串(仅适用于 ARE)

先行约束不能包含反向引用(参见第 9.7.3.3 节),其中的所有圆括号都视为非捕获圆括号。

9.7.3.2. 方括号表达式 #

方括号表达式是用[]括起来的字符列表。通常,它匹配列表中的任意单个字符(但请参见下文)。如果列表以^开头,则匹配任意在列表剩余部分中的单个字符。如果列表中的两个字符用-分隔,则表示排序序列中这两个字符之间的完整字符范围(包含两个端点);例如,ASCII中的[0-9]匹配任意十进制数字。两个范围共享一个端点是不合法的,例如a-c-e。范围高度依赖排序序列,因此可移植程序应避免依赖它们。

想在列表中包含字面字符],可以让它做列表的首字符(如果使用了^,需要放在其后)。 想在列表中包含字面字符-,可以让它做列表的首字符或者尾字符,或者一个范围的第二个端点。 想在列表中把字面字符-当做范围的起点, 把它用[..]包围起来,这样它就成为一个排序元素(见下文)。 除了这些字符本身、一些用[的组合(见下段)以及转义(只在 ARE 中有效)以外,所有其它特殊字符 在方括号表达式里都失去它们的特殊含义。特别是,在 ERE 和 BRE 规则下\不是特殊的, 但在 ARE 里,它是特殊的(引入一个转义)。

在一个方括号表达式里,一个排序元素(一个字符、一个被当做一个单一字符排序的多字符序列或者一个表示上面两种情况的排序序列名称) 包含在[..]里面的时候表示该排序元素的字符序列。该序列被当做该方括号列表 的一个单一元素。这允许一个包含多字符排序元素的方括号表达式去匹配多于一个字符,例如,如果排序序列包含一个ch排序元素, 那么 RE [[.ch.]]*c匹配chchcc的头五个字符。

注意

PostgreSQL当前不支持多字符排序元素。这些信息描述了将来可能有的行为。

在方括号表达式里,包围在[==]里的排序元素是一个等价类, 代表等效于那一个的所有排序元素的字符序列,包括它本身(如果没有其它等效排序元素,那么就好像封装定界符是[..])。例如,如果o^是一个等价类的成员,那么[[=o=]][[=^=]][o^]都是同义的。一个等价类不能是一个范围的端点。

在方括号表达式中,用 [::] 括起的字符类名表示属于该类的所有字符的列表。标准字符类名包括:alnumalphablankcntrldigitgraphlowerprintpunctspaceupperxdigit。它们表示 ctype 中定义的字符类。区域设置可以提供其他字符类。字符类不能用作范围的端点。

方括号表达式有两个特例:[[:<:]][[:>:]] 是约束,分别匹配单词开头和结尾的空字符串。单词定义为一个前后都没有单词字符的单词字符序列。单词字符是 alnum 字符(由 ctype 定义)或下划线。这是与 POSIX 1003.2 兼容但未由其规定的扩展,在打算移植到其他系统的软件中应谨慎使用。通常更适合使用下文介绍的约束转义;它们并不更标准,但更容易键入。

9.7.3.3. 正则表达式转义 #

转义是以\开头,后面跟着一个字母或数字字符的特殊序列。 转义有好几种变体:字符输入转义、字符类简写转义、约束转义以及反向引用。在 ARE 里, 如果一个\后面跟着一个字母或数字,但是并未组成一个合法的转义, 那么它是非法的。在 ERE 中没有转义:在方括号表达式之外,一个后面跟着字母或数字字符的\只是表示该字符是一个普通的字符,而且在一个方括号表达式里,\是一个普通的字符(后者是 ERE 与 ARE 之间唯一的实际不兼容之处)。

字符输入转义便于在 RE 中指定不可打印或其他不便输入的字符,见表 9.16

字符类简写转义用来提供一些常用的字符类简写。它们显示在表 9.17中。

约束转义是以转义形式书写的约束,在满足特定条件时匹配空字符串,见表 9.18

反向引用\n)匹配数字n指定的被前面的圆括号子表达式匹配的同一个串 (参阅表 9.19)。 例如, ([bc])\1匹配bb或者cc, 但是不匹配bc或者cb。 RE 中子表达式必须完全在反向引用前面。子表达式以它们的左圆括号的顺序编号。 非捕获圆括号并不定义子表达式。

表 9.16. 正则表达式字符输入转义

转义 描述
\a 警告(响铃)字符,和 C 中一样
\b 退格,和 C 中一样
\B 反斜线(\)的同义词,用来减少双写反斜线
\cX (其中X是任意字符)低序5位和X相同的字符,它的其他位都是零
\e 排序序列名称为ESC的字符;若不存在这样的字符,则使用八进制值为033的字符
\f 换页,和 C 中一样
\n 换行符,与 C 中相同
\r 回车,和 C 中一样
\t 水平制表符,和 C 中一样
\uwxyz (其中wxyz正好是四个十六进制位)十六进制值为0xwxyz的字符
\Ustuvwxyz (其中stuvwxyz正好是八个十六进制位)十六进制值为0xstuvwxyz的字符
\v 垂直制表符,和 C 中一样
\xhhh (其中hhh是十六进制位的任意序列)十六进制值为0xhhh的字符(一个单一字符,不管用了多少个十六进制位)
\0 值为0(空字节)的字符
\xy (其中xy正好是两个八进制位,并且不是一个反向引用)八进制值为0xy的字符
\xyz (其中xyz正好是三个八进制位,并且不是一个反向引用)八进制值为0xyz的字符

十六进制位是0-9a-fA-F。八进制位是0-7

指定 ASCII 范围(0[ndash ]127)之外的值的数字字符输入转义的含义取决于数据库编码。 当编码是 UTF-8 时,转义值等价于 Unicode 代码点,例如 \u1234表示字符U+1234。对于其他多字节编码, 字符输入转义通常只是指定该字符的字节值的串接。如果该转义值不对应数据库编码 中的任何合法字符,将不会发生错误,但是它不会匹配任何数据。

字符输入转义总是被当作普通字符。例如,\135是 ASCII 中的], 但\135并不终止一个方括号表达式。

表 9.17. 正则表达式字符类简写转义

转义 描述
\d [[:digit:]]
\s [[:space:]]
\w [[:alnum:]_](注意包括下划线)
\D [^[:digit:]]
\S [^[:space:]]
\W [^[:alnum:]_](注意包括下划线)

在方括号表达式中,\d\s\w 会失去其外层方括号,而 \D\S\W 则是非法的。(因此,例如 [a-c\d] 等同于 [a-c[:digit:]]。此外,等同于 [a-c^[:digit:]][a-c\D] 是非法的。)

表 9.18. 正则表达式约束转义

转义 描述
\A 只在串开头匹配(与^的不同请参见第 9.7.3.5 节
\m 只在一个词的开头匹配
\M 只在一个词的末尾匹配
\y 只在一个词的开头或末尾匹配
\Y 只在不属于单词开头或末尾的位置匹配
\Z 只在串的末尾匹配(与$的不同请参见第 9.7.3.5 节

单词的定义与上文[[:<:]][[:>:]]的说明相同。方括号表达式中不允许使用约束转义。

表 9.19. 正则表达式反向引用

转义 描述
\m (其中m是一个非零数字)一个到第m个子表达式的反向引用
\mnn (其中m是一个非零数字,并且nn是后续的若干数字,并且十进制值mnn不大于此前已出现的捕获右圆括号数)一个到第mnn个子表达式的反向引用

注意

八进制字符输入转义与反向引用之间存在固有歧义,按上文提到的启发式规则解决:前导零始终表示八进制转义。单个非零数字,如果后面没有其他数字,始终视为反向引用。不以零开头的多位数字序列,如果前面已有相应的子表达式(即该数字在反向引用的合法范围内),则视为反向引用,否则视为八进制转义。

9.7.3.4. 正则表达式元语法 #

除了上面描述的主要语法之外,还有几种特殊形式和杂项语法。

RE 可以以两种特殊的引导前缀之一开头。如果 RE 以***:开头,余下部分就被视为 ARE。(这在PostgreSQL中通常没有影响,因为 RE 默认被视为 ARE;但如果通过正则表达式函数的flags参数指定了 ERE 或 BRE 模式,它就会产生影响。)如果 RE 以***=开头,余下部分就作为按字面解释的字符串处理,所有字符都视为普通字符。

一个 ARE 可以以嵌入选项开头:一个序列(?xyz)(这里的xyz是一个或多个字母字符)声明影响剩余 RE 的选项。 这些选项覆盖任何先前确定的选项 — 特别地,它们可以覆盖一个正则表达式操作符隐含的大小写敏感的行为,或者覆盖正则表达式函数的flags参数所指定的选项。可用的选项字母在表 9.20中显示。注意这些同样的选项字母也被用在正则表达式函数的flags参数中。

表 9.20. ARE 嵌入选项字母

选项 描述
b RE的剩余部分是一个BRE
c 大小写敏感的匹配(覆盖操作符类型)
e RE的剩余部分是一个ERE
i 大小写不敏感的匹配(见第 9.7.3.5 节)(覆盖操作符类型)
m n的历史原因的同义词
n 换行敏感的匹配(见第 9.7.3.5 节
p 部分换行敏感的匹配(见第 9.7.3.5 节
q RE 的剩余部分按字面(加引号)解释,所有字符都视为普通字符
s 非换行敏感的匹配(默认)
t 紧凑语法(默认;见下文)
w 逆部分换行敏感(怪异)的匹配(见第 9.7.3.5 节
x 扩展语法(见下文)

嵌入选项从结束该序列的)处开始生效。它们只能出现在 ARE 的开头(如果存在***:引导前缀,则位于该前缀之后)。

除了通常的紧凑 RE 语法(其中所有字符都有意义)之外,还有一种扩展语法,可以通过指定嵌入的x选项来使用。在扩展语法中,RE 中的空白字符会被忽略,同样被忽略的还有#与其后的换行符(或 RE 末尾)之间的所有字符。这使得复杂的 RE 可以分段并添加注释。此基本规则有三个例外:

  • 空白字符或 # 的前面若有 \,该字符就会被保留。

  • 方括号表达式里的空白或者#将被保留

  • 在多字符符号里面不能出现空白和注释,例如(?:

在这里,空白字符包括空格、制表符、换行符,以及属于space字符类的任何字符。

最后,在 ARE 里,方括号表达式外面,序列(?#ttt)(其中ttt是任意不包含一个)的文本)是一个注释, 它被完全忽略。同样,这样的东西是不允许出现在多字符符号的字符中间的,例如 (?:。这种注释更像是一种历史产物而不是一种有用的设施,并且它们的使用已经被废弃;请使用扩展语法来替代。

如果指定了开头的***=引导前缀,那么这些元语法扩展都不能使用,因为这表示把用户输入作为按字面解释的字符串,而非 RE 处理。

9.7.3.5. 正则表达式匹配规则 #

在 RE 可以在给定串中匹配多于一个子串的情况下, RE 匹配串中最靠前的那个子串。如果 RE 可以匹配在那个位置开始 的多个子串,要么是取最长的子串,要么是最短的,具体哪种, 取决于 RE 是贪婪的还是非贪婪的。

一个 RE 是否贪婪取决于下面规则:

  • 大多数原子以及所有约束,都没有贪婪属性(因为它们毕竟无法匹配长度不定的文本)。

  • 在一个 RE 周围加上圆括号并不会改变其贪婪性。

  • 带一个固定重复次数量词 ({m}或者{m}?) 的量化原子和原子自身具有同样的贪婪性(可能是没有)。

  • 一个带其他普通的量词(包括{m,n}m等于n的情况)的量化原子是贪婪的(首选最长匹配)。

  • 一个带非贪婪量词(包括{m,n}?m等于 n的情况)的量化原子是非贪婪的(首选最短匹配)。

  • 一个分支 — 也就是说,一个没有顶级|操作符的 RE — 和它里面的第一个有贪婪属性的量化原子有着同样的贪婪性。

  • 一个由|操作符连接起来的两个或者更多分支组成的 RE 总是贪婪的。

上面的规则所描述的贪婪属性不仅仅适用于独立的量化原子, 而且也适用于包含量化原子的分支和整个 RE。这里的意思是, 匹配是按照分支或者整个 RE 作为一个整体匹配最长或者最短的可能子串。 一旦整个匹配的长度确定,那么匹配任意特定子表达式的部分就基于该子表达式的贪婪属性进行判断,在 RE 里面靠前的子表达式的优先级高于靠后的子表达式。

一个相应的示例:

SELECT SUBSTRING('XY1234Z', 'Y*([0-9]{1,3})');
结果:123
SELECT SUBSTRING('XY1234Z', 'Y*?([0-9]{1,3})');
结果:1

在第一个示例里,RE 作为整体是贪婪的,因为Y*是贪婪的。它可以匹配从Y开始的东西,并且它匹配从这个位置开始的最长的串, 也就是,Y123。输出是这里的圆括号包围的部分,或者说是123。在第二个示例里, RE 总体上是一个非贪婪的 RE,因为Y*?是非贪婪的。它可以匹配从Y开始的最短的子串,也就是说Y1。子表达式[0-9]{1,3}是贪婪的,但是它不能修改总体匹配长度的决定; 因此它被迫只匹配1

简而言之,如果一个 RE 同时包含贪婪和非贪婪的子表达式,那么总的匹配长度要么是尽可能长,要么是尽可能短,这取决于给整个 RE 赋予的属性。给子表达式赋予的属性只影响在这个匹配里,各个子表达式相对于其他子表达式能吃掉多少内容。

量词{1,1}{1,1}?可以分别用于在一个子表达式 或者整个 RE 上强制贪婪或者非贪婪。当需要整个 RE 具有不同于从其元素中 推导出的贪婪属性时,这很有用。例如,假设我们尝试将一个包含一些数字的 字符串分隔成数字以及在它们之前和之后的部分,我们可能会尝试这样做:

SELECT regexp_matches('abc01234xyz', '(.*)(\d+)(.*)');
结果:{abc0123,4,xyz}

这不会有用:第一个.*是贪婪的,因此它会吃掉 尽可能多的字符而留下\d+去匹配在最后一个可能位置上的最 后一个数字。我们可能会通过让它变成非贪婪来修复:

SELECT regexp_matches('abc01234xyz', '(.*?)(\d+)(.*)');
结果:{abc,0,""}

这也不会有用:因为现在 RE 作为整体来说是非贪婪的,因此它会尽快结束 全部的匹配。我们可以通过强制 RE 整体是贪婪的来得到我们想要的:

SELECT regexp_matches('abc01234xyz', '(?:(.*?)(\d+)(.*)){1,1}');
结果:{abc,01234,xyz}

独立于 RE 的组件的贪婪性之外控制 RE 的整体贪婪性为处理变长模式提供了 很大的灵活性。

在决定更长或者更短的匹配时,匹配长度是以字符衡量的,而不是排序元素。一个空串会被认为比什么都不匹配长。例如:bb*匹配abbbc的中间三个字符;(week|wee)(night|knights)匹配weeknights的所有十个字符; 而(.*).*匹配 abc的时候,圆括号包围的子表达式匹配所有三个字符;当(a*)*被拿来匹配bc时,整个 RE 和圆括号 子表达式都匹配一个空串。

如果指定不区分大小写的匹配,其效果近似于字母表中的所有大小写差别都消失了。当存在大小写形式的字母作为普通字符出现在方括号表达式之外时,实际上会转换为包含其大小写形式的方括号表达式,例如x变成[xX]。当它出现在方括号表达式内部时,其所有大小写形式都会加入该表达式,例如[x]变成[xX][^x]变成[^xX]

如果指定了换行敏感的匹配,.和使用^的方括号表达式 将永远不会匹配换行字符(这样,匹配就不会跨越行,除非 RE 显式安排了跨行匹配)并且^$除了分别匹配串开头和结尾之外,还将分别匹配换行后面和前面的空串。 但是 ARE 转义\A\Z仍然匹配串的开头和结尾。

如果指定了部分换行敏感的匹配,那么它影响.和方括号表达式, 这个时候和换行敏感的匹配一样,但是不影响^$

如果指定了逆部分换行敏感匹配,那么它影响^$,其作用和在换行敏感的匹配里一样,但是不影响.和方括号表达式。这个并不是很有用,只是为了满足对称性而提供的。

9.7.3.6. 限制和兼容性 #

在这个实现里,对 RE 的长度没有特别的限制。但是,那些希望高移植性的程序应该避免使用长度超过 256 字节的 RE,因为 POSIX 兼容 的实现可以拒绝接受这样的 RE。

ARE 与 POSIX ERE 实际不兼容的唯一特性是:\在方括号表达式中不会失去特殊含义。其他所有 ARE 特性所使用的语法,在 POSIX ERE 中都是非法的,或其效果未定义或未指定;引导前缀的***语法同样不属于 POSIX 的 BRE 或 ERE 语法。

许多 ARE 扩展借鉴自 Perl,但其中一些经过了整理和修改,也未实现少数 Perl 扩展。需要注意的不兼容之处包括\b\B、不对末尾换行符作特殊处理、取反的方括号表达式也受换行敏感匹配影响、先行约束中对圆括号及反向引用的限制,以及采用最长或最短匹配而非首次匹配的语义。

ARE 与旧版 ERE 语法存在两点重要的不兼容,这里比较的是 7.4 之前的PostgreSQL

  • 在 ARE 中,\ 后跟字母或数字字符时,要么表示转义,要么是错误;而在以前的版本中,它只是书写该字母或数字字符的另一种方式。这应该不是什么大问题,因为以前的版本没有理由使用这样的序列。

  • 在 ARE 中,\[] 内仍是特殊字符,因此方括号表达式内的字面 \ 必须写成 \\

9.7.3.7. 基本正则表达式 #

BRE 在几个方面和 ERE 不太一样。在 BRE 中,|+?都是普通字符并且没有与它们功能等价的东西。范围的定界符是\{\},而{}本身是普通字符。嵌套的子表达式的圆括号是\(\),而()自身是普通字符。除非在 RE 开头或者是圆括号子表达式开头,^都是一个普通字符。 除非在 RE 结尾或者是圆括号子表达式的结尾,$是一个普通字符。如果*出现在 RE 开头或者是圆括号封装的子表达式开头 (前面可能有^),那么它是个普通字符。最后,可以用单数字的反向引用,\<\>分别是[[:<:]][[:>:]]的同义词;在 BRE 中没有其它可用的转义。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。