# REGEXP\_REPLACE

Заменяет каждое вхождение подстроки, соответствующей шаблону регулярного выражения в заданной строке, указанной заменой.

## Синтаксис

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

## Аргументы

#### STRING

Тип: `string`

Строка, в которой ищется совпадение с `PATTERN`.

#### PATTERN

Тип: `string`

Шаблон регулярного выражения.

Этот шаблон должен быть регулярным выражением Java. Строковые литералы не экранируются. Например, чтобы сопоставить `'\abc'`, регулярное выражение будет `'^\\abc$'`.

Дополнительную информацию см. в [таблице шаблонов RegEx](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/TransformationFunctions/regular-expressions/regular-expressions.htm#regular-expression-patterns).

#### REPLACEMENT

Тип: `string`

Строка, используемая для замены экземпляров `PATTERN`, найденных в `STRING`.

[Захватывающие группы](http://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html#cg) можно ссылаться в `REPLACEMENT` с помощью `$g` для нумерованной группы или `${name}` для именованной группы. Знак доллара (`$`) может быть включен в замену путем экранирования его обратной косой чертой (`\$`):

## Возвращает

Тип: `string`

`STRING` со всеми вхождениями подстроки, соответствующей регулярному выражению `PATTERN`, замененными на `REPLACEMENT`.

***

## Примеры

| STRING | PATTERN | REPLACEMENT | Выходные данные |
| --- | --- | --- | --- |
| Привет, мир | w | W | Привет, мир |
| Привет, мир | o | 0 | Привет, мир! |
| Бонд, Джеймс | (\w+)\W+(\w+) | Зовут $1. $2 $1. | Зовут Бонд. Джеймс Бонд. |
| Привет, мир! | ! | `''` | Привет, мир |
| Привет xxWorld | x | `''` | Привет, мир |
| Привет, мир! | l(?= ) | `''` | Привет, мир! |
| Привет, мир! | l(?![lod]) | `''` | Привет, мир! |
| Привет, мир | (?<br>&lt;=o)o | `''` | Привет, мир |
| Привет, мирW | (?&lt;! )W | `''` | Привет, мир |
| `null` | '(?&lt;! )W | `''` | `null` |