# REGEXP\_REPLACE

指定された文字列内の正規表現パターンに一致する部分文字列のすべてのインスタンスを、指定された置換文字列で置き換えます。

## 構文

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

## 引数

#### STRING

型: `string`

`PATTERN` の一致を検索する文字列。

#### PATTERN

型: `string`

正規表現パターン

このパターンは Java の正規表現である必要があります。文字列リテラルはエスケープされません。たとえば、`'\abc'` に一致させるには、正規表現は `'^\\abc$'` になります。

詳細については、[正規表現パターンテーブル](https://help.qlik.com/ja-JP/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)は、番号付きグループの場合は `$g` を、名前付きグループの場合は `${name}` を使用して、`REPLACEMENT` で参照できます。ドル記号 (`$`) は、バックスラッシュ (`\$`) でエスケープすることで、置換に含めることができます。

## 戻り値

型: `string`

`STRING` の、正規表現 `PATTERN` に一致する部分文字列のすべてのインスタンスを `REPLACEMENT` に置き換えたもの。

***

## 例

| STRING | PATTERN | REPLACEMENT | 出力 |
| --- | --- | --- | --- |
| Hello world | w | W | Hello World |
| Hello World | o | 0 | Hell0 World |
| Bond, James | (\w+)\W+(\w+) | The names $1. $2 $1. | The names Bond. James Bond. |
| Hello World! | ! | `''` | Hello World |
| Hello xxWorld | x | `''` | Hello World |
| Hellol World | l(?= ) | `''` | Hello World |
| Hellol World | l(?![lod]) | `''` | Hello World |
| Helloo World | (?<=o)o | `''` | Hello World |
| Hello WorldW | (?<! )W | `''` | Hello World |
| `null` | '(?<! )W | `''` | `null` |