REGEXP_REPLACE 函數

在字串中搜尋規則表達式模式，並以指定的字串取代每一個出現的模式。REGEXP_REPLACE 類似於 REPLACE 函數，但可讓您在字串中搜尋規則表達式模式。有關正則表達式的更多信息，請參閱POSIX 運算子維基百科中的正則表達式。

REGEXP_REPLACE 類似於 TRANSLATE 函數 和 REPLACE 函數，但 TRANSLATE 會進行多次單一字元替換，REPLACE 會將一整個字串替換成另一個字串，而 REGEXP_REPLACE 可讓您在字串中搜尋規則表達式模式。

語法

REGEXP_REPLACE( source_string, pattern [, replace_string [ , position [, parameters ] ] ] )

引數

source_string

要搜尋的 CHAR 或 VARCHAR 字串運算式，例如欄名。

pattern

代表規則運算式模式的 UTF-8 字串常值。如需詳細資訊，請參閱 POSIX 運算子。

replace_string

(選用) CHAR 或 VARCHAR 字串運算式 (例如欄名)，用於搜尋每一個出現的模式。預設為空字串 ( "" )。

position

(選用) 正整數，表示在 source_string 內開始搜尋的位置。位置以字元數為基礎，而不是位元組，所以多位元組字元視為單一字元。預設值為 1。如果 position 小於 1，則從 source_string 的第一個字元開始搜尋。如果 position 大於 source_string 中的字元數，則結果為 source_string。

參數

(選用) 一或多個字串常值，表示函數如何比對模式。可能值如下：

• c - 進行區分大小寫比對。預設是使用區分大小寫比對。

• i - 進行不區分大小寫比對。

• p - 使用 Perl 相容規則運算式 (PCRE) 方言解釋此模式。有關 PCRE 的更多信息，請參閱維基百科中的 Perl 兼容正則表達式。

傳回類型

VARCHAR

如果 pattern 或 replace_string 為 NULL，函數會傳回 NULL。

範例

若要使用不區分大小寫的比對取代值 quick brown fox 內所有出現的字串 FOX，請使用下列範例。

SELECT REGEXP_REPLACE('the fox', 'FOX', 'quick brown fox', 1, 'i');

+---------------------+
|   regexp_replace    |
+---------------------+
| the quick brown fox |
+---------------------+

下列範例會使用 PCRE 方言撰寫的模式來尋找至少包含一個數字和一個小寫字母的字詞。它使用 ?= 運算子，該運算子在 PCRE 中具有特定的前瞻內涵。若要以值 [hidden] 取代這類字詞的每個出現值，請使用下列範例。

SELECT REGEXP_REPLACE('passwd7 plain A1234 a1234', '(?=[^ ]*[a-z])(?=[^ ]*[0-9])[^ ]+', '[hidden]', 1, 'p');

+-------------------------------+
|        regexp_replace         |
+-------------------------------+
| [hidden] plain A1234 [hidden] |
+-------------------------------+

下列範例會使用 PCRE 方言撰寫的模式來尋找至少包含一個數字和一個小寫字母的字詞。它使用 ?= 運算子，該運算子在 PCRE 中具有特定的前瞻內涵。若要以值 [hidden] 取代這類字詞的每個出現值，但與前面的範例不同之處在於它使用不區分大小寫的比對，請使用下列範例。

SELECT REGEXP_REPLACE('passwd7 plain A1234 a1234', '(?=[^ ]*[a-z])(?=[^ ]*[0-9])[^ ]+', '[hidden]', 1, 'ip');

+----------------------------------+
|          regexp_replace          |
+----------------------------------+
| [hidden] plain [hidden] [hidden] |
+----------------------------------+

下列範例使用 TICKIT 範例資料庫中 USERS 資料表的資料。如需詳細資訊，請參閱 範本資料庫。

若要從電子郵件地中刪除 @ 和網域名稱，請使用下列範例。

SELECT email, REGEXP_REPLACE(email, '@.*\\.(org|gov|com|edu|ca)$')
FROM users
ORDER BY userid LIMIT 4;

+-----------------------------------------------+-----------------------+
|                     email                     |    regexp_replace     |
+-----------------------------------------------+-----------------------+
| [e-mail] | Etiam.laoreet.libero  |
| [e-mail]       | Suspendisse.tristique |
| [e-mail]   | amet.faucibus.ut      |
| [e-mail]                             | sed                   |
+-----------------------------------------------+-----------------------+

若要以 internal.company.com 取代電子郵件地址的網域名稱，請使用下列範例。

SELECT email, REGEXP_REPLACE(email, '@.*\\.[[:alpha:]]{2,3}','@internal.company.com') 
FROM users
ORDER BY userid LIMIT 4;

+-----------------------------------------------+--------------------------------------------+
|                     email                     |               regexp_replace               |
+-----------------------------------------------+--------------------------------------------+
| [e-mail] | [e-mail]  |
| [e-mail]       | [e-mail] |
| [e-mail]   | [e-mail]      |
| [e-mail]                             | [e-mail]                   |
+-----------------------------------------------+--------------------------------------------+