Oracle REGEXP_COUNT() 函数使用指南
Oracle REGEXP_COUNT()
是一个内置函数,它返回一个给定的正则表达式模式在一个源字符串中出现的次数。
Oracle REGEXP_COUNT()
语法
这里是 Oracle REGEXP_COUNT()
函数的语法:
REGEXP_COUNT(source_char, pattern)
REGEXP_COUNT(source_char, pattern, position)
REGEXP_COUNT(source_char, pattern, position, match_param)
参数
source_char
-
必需的。从中搜索的字符串。它可以是
CHAR
,VARCHAR2
,NCHAR
,NVARCHAR2
,CLOB
, 或NCLOB
中的任何一种数据类型。 pattern
-
必需的。正则表达式。它可以是
CHAR
,VARCHAR2
,NCHAR
, 或NVARCHAR2
中的任何一种数据类型。它最多包含 512 字节。 position
-
可选的。它是一个整数,指示开始搜索的起始位置。默认为
1
。 match_param
-
可选的。执行匹配采用的模式。它可以是
VARCHAR2
或CHAR
。您可以通过此参数改变默认的搜索行为。您可以使用以下的一个或多个字符:'i'
指定不区分大小写的匹配,即使确定的条件排序规则区分大小写。'c'
指定区分大小写和区分重音的匹配,即使确定的条件排序规则不区分大小写或不区分重音。'n'
允许句点 (.
)(匹配任意字符)匹配换行符。如果省略此参数,则句点与换行符不匹配。'm'
将源字符串视为多行。Oracle 将插入符号 (^
) 和美元符号 ($
) 分别解释为源字符串中任意行的开始和结束,而不仅仅是整个源字符串的开始或结束。如果省略此参数,则 Oracle 会将源字符串视为单行。'x'
忽略空白字符。默认情况下,空白字符匹配自身。
返回值
Oracle REGEXP_COUNT()
函数返回一个整数,它是给定的正则表达式模式在一个源字符串中出现的次数。
如果源字符串没有与正则表达式模式匹配的内容, REGEXP_COUNT()
将返回 0
。
如果前 3 个中的任意一个参数为 NULL
, REGEXP_COUNT()
将返回 NULL
。
Oracle REGEXP_COUNT()
示例
这里有几个展示了 Oracle REGEXP_COUNT()
函数用法的示例。
基本用法
下面的语句尝试在 ABCabacbcabc
中搜索正则表达式 (a|b)c
,并返回出现的次数:
SELECT
REGEXP_COUNT('ABCabacbcabc', '(a|b)c') "Result"
FROM dual;
输出:
Result
_________
3
在 ABCabacbcabc
中,有 3 个与 (a|b)c
匹配的内容,ac
,bc
和 bc
。
起始位置
Oracle REGEXP_COUNT()
函数允许您指定开始搜索的位置:
SELECT
REGEXP_COUNT('ABCabacbcabc', '(a|b)c', 7) "Result"
FROM dual;
输出:
Result
_________
2
在本示例中,从第 7 个开始搜索,因此只有两个匹配的内容,bc
和 bc
。
匹配参数
Oracle REGEXP_COUNT()
函数允许您指定匹配参数以改变搜索的行为。 Oracle 默认执行区分大小写的搜索,如果您不区分大小写,请使用 i
参数。
SELECT
REGEXP_COUNT('ABCabacbcabc', '(a|b)c', 1, 'i') "Result"
FROM dual;
输出:
Result
_________
4
在本示例中,有 4 个匹配的内容,BC
, ac
,bc
和 bc
。
无匹配
如果源字符串没有与正则表达式模式匹配的内从, REGEXP_COUNT()
将返回 0
。
SELECT
REGEXP_COUNT('ABCabacbcabc', '[0-9]') "Result"
FROM dual;
输出:
Result
_________
0
NULL 参数
如果前 3 个中的任意一个参数为 NULL
, REGEXP_COUNT()
将返回 NULL
。
SET NULL 'NULL';
SELECT
REGEXP_COUNT(NULL, 'a') "Result1",
REGEXP_COUNT('a', NULL) "Result2",
REGEXP_COUNT('a', 'b', NULL) "Result3"
FROM dual;
输出:
Result1 Result2 Result3
__________ __________ __________
NULL NULL NULL
在本示例中,我们使用 SET NULL 'NULL';
语句将 NULL
值显示为 'NULL'
字符串。
结论
Oracle REGEXP_COUNT()
是一个内置函数,它返回一个给定的正则表达式模式在一个源字符串中出现的次数。