# REGEXP\_REPLACE

將指定字串中符合規則運算式模式的每個子字串執行個體取代為指定的取代項目。

## 語法

```
REGEXP_REPLACE(STRING, PATTERN, REPLACEMENT)
```

## 引數

#### STRING

類型： `string`

搜尋 `PATTERN` 相符項目的字串。

#### PATTERN

類型： `string`

正規表達式模式。

此模式必須是 Java 正規表達式。字串常值未逸出。例如，若要比對 `'\abc'`，正規表達式會是 `'^\\abc$'`。

如需詳細資訊，請參閱[RegEx 模式表](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/TransformationFunctions/regular-expressions/regular-expressions.htm#regular-expression-patterns)。

#### REPLACEMENT

類型：`string`

用於取代在`STRING`中找到的`PATTERN`執行個體的字串。

[擷取群組](http://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html#cg)可以在`REPLACEMENT`中參考，使用`$g`表示編號群組，或使用`${name}`表示命名群組。美元符號 (`$`) 可以透過反斜線 (`\$`) 逸出，以包含在取代中：

## 傳回

類型： `string`

`STRING`，其中每個符合正規表達式 `PATTERN` 的子字串執行個體都以 `REPLACEMENT` 取代。

***

## 範例

| 字串 | PATTERN | REPLACEMENT | 輸出 |
| --- | --- | --- | --- |
| 哈囉世界 | w | W | 哈囉世界 |
| 哈囉世界 | o | 0 | 哈囉世界 |
| Bond, James | (\w+)\W+(\w+) | 我的名字是 $1。$2 $1。 | 我的名字是 Bond。詹姆士·龐德。 |
| 哈囉世界！ | ! | `''` | 哈囉世界 |
| 哈囉 xxWorld | x | `''` | 哈囉世界 |
| 哈囉世界 | l(?= ) | `''` | 哈囉世界 |
| 哈囉世界 | l(?![lod]) | `''` | 哈囉世界 |
| 哈囉世界 | (?<=o)o | `''` | 哈囉世界 |
| 哈囉世界W | (?<! )W | `''` | 哈囉世界 |
| `null` | '(?<! )W | `''` | `null` |