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

可选的。执行匹配采用的模式。它可以是 VARCHAR2CHAR。您可以通过此参数改变默认的搜索行为。您可以使用以下的一个或多个字符:

  • 'i' 指定不区分大小写的匹配,即使确定的条件排序规则区分大小写。
  • 'c' 指定区分大小写和区分重音的匹配,即使确定的条件排序规则不区分大小写或不区分重音。
  • 'n' 允许句点 (.)(匹配任意字符)匹配换行符。如果省略此参数,则句点与换行符不匹配。
  • 'm' 将源字符串视为多行。Oracle 将插入符号 (^) 和美元符号 ($) 分别解释为源字符串中任意行的开始和结束,而不仅仅是整个源字符串的开始或结束。如果省略此参数,则 Oracle 会将源字符串视为单行。
  • 'x' 忽略空白字符。默认情况下,空白字符匹配自身。

返回值

Oracle REGEXP_COUNT() 函数返回一个整数,它是给定的正则表达式模式在一个源字符串中出现的次数。

如果源字符串没有与正则表达式模式匹配的内容, REGEXP_COUNT() 将返回 0

如果前 3 个中的任意一个参数为 NULLREGEXP_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 匹配的内容,acbcbc

起始位置

Oracle REGEXP_COUNT() 函数允许您指定开始搜索的位置:

SELECT
    REGEXP_COUNT('ABCabacbcabc', '(a|b)c', 7) "Result"
FROM dual;

输出:

   Result
_________
        2

在本示例中,从第 7 个开始搜索,因此只有两个匹配的内容,bcbc

匹配参数

Oracle REGEXP_COUNT() 函数允许您指定匹配参数以改变搜索的行为。 Oracle 默认执行区分大小写的搜索,如果您不区分大小写,请使用 i 参数。

SELECT
    REGEXP_COUNT('ABCabacbcabc', '(a|b)c', 1, 'i') "Result"
FROM dual;

输出:

   Result
_________
        4

在本示例中,有 4 个匹配的内容,BC, acbcbc

无匹配

如果源字符串没有与正则表达式模式匹配的内从, REGEXP_COUNT() 将返回 0

SELECT
    REGEXP_COUNT('ABCabacbcabc', '[0-9]') "Result"
FROM dual;

输出:

   Result
_________
        0

NULL 参数

如果前 3 个中的任意一个参数为 NULLREGEXP_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() 是一个内置函数,它返回一个给定的正则表达式模式在一个源字符串中出现的次数。