Oracle REGEXP_REPLACE() 函数使用指南

Oracle REGEXP_REPLACE() 是一个内置函数，它在一个字符串中使用新内容替换一个和指定的正则表达式匹配的内容。

您可以认为该函数是增加了正则表达式的 REPLACE()。

Oracle `REGEXP_REPLACE()` 语法

这里是 Oracle REGEXP_REPLACE() 函数的语法：

REGEXP_REPLACE(source_char, pattern)
REGEXP_REPLACE(source_char, pattern, replace_string)
REGEXP_REPLACE(source_char, pattern, replace_string, position)
REGEXP_REPLACE(source_char, pattern, replace_string, position, occurrence)
REGEXP_REPLACE(source_char, pattern, replace_string, position, occurrence, match_param)

参数

source_char

必需的。从中搜索的字符串。它可以是 CHAR, VARCHAR2, NCHAR, NVARCHAR2, CLOB, 或 NCLOB 中的任何一种数据类型。

pattern

必需的。正则表达式。它可以是 CHAR, VARCHAR2, NCHAR, 或 NVARCHAR2 中的任何一种数据类型。它最多包含 512 字节。

replace_string

可选的。被替换成的新内容。

position

可选的。它是一个整数，指示开始搜索的起始位置。默认为 1。

occurrence

可选的。它是一个整数，指示要返回的是第几次出现。默认为 0，即全部替换。

match_param

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

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

返回值

Oracle REGEXP_REPLACE() 函数在一个字符串中使用新内容替换一个和指定的正则表达式匹配的内容，它返回替换后的内容。

如果任意一个参数为 NULL， REGEXP_REPLACE() 将返回 NULL。

Oracle `REGEXP_REPLACE()` 示例

这里有几个展示了 Oracle REGEXP_REPLACE() 函数用法的示例。

基本用法

SELECT
  REGEXP_REPLACE('123 abc 456 def', '\s+', '-') Result
FROM dual;

输出：

RESULT
__________________
123-abc-456-def

起始位置

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

SELECT
  REGEXP_REPLACE('123 abc 456 def', '\s+', '-', 5) Result
FROM dual;

输出：

RESULT
__________________
123 abc-456-def

在本示例中，从第 5 个开始搜索，因此第一个空格没有被替换。

第几次出现

Oracle REGEXP_REPLACE() 函数允许您指定替换第几次出现：

SELECT
  REGEXP_REPLACE('123 abc 456 def', '\s+', '-', 1, 0) Result1,
  REGEXP_REPLACE('123 abc 456 def', '\s+', '-', 1, 2) Result2
FROM dual;

输出：

RESULT1            RESULT2
__________________ __________________
123-abc-456-def    123 abc-456 def

注意， occurrence 的默认值是 0, Oracle 将会替换所有的匹配项，否则 Oracle 将替换指定的匹配项。

NULL 参数

如果任意一个参数为 NULL， REGEXP_REPLACE() 将返回 NULL。

SET NULL 'NULL';
SELECT
    REGEXP_INSTR(NULL, 'a') "Result1",
    REGEXP_INSTR('a', NULL) "Result2",
    REGEXP_INSTR('a', 'b', NULL) "Result3",
    REGEXP_INSTR('a', 'b', '', NULL) "Result4",
    REGEXP_INSTR('a', 'b', '', 1, NULL) "Result5",
    REGEXP_INSTR('a', 'b', '', 1, 1, NULL) "Result6"
FROM dual;

输出：

   Result1    Result2    Result3    Result4    Result5    Result6
__________ __________ __________ __________ __________ __________
      NULL       NULL       NULL       NULL       NULL       NULL

在本示例中，我们使用 SET NULL 'NULL'; 语句将 NULL 值显示为 'NULL' 字符串。

结论