# REGEXP\_REPLACE

Substitui cada instância da subcadeia de caracteres correspondida por um padrão de expressão regular na cadeia de caracteres fornecida por uma substituição especificada.

## Sintaxe

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

## Argumentos

#### STRING

Tipo: `string`

A cadeia de caracteres que é pesquisada por uma correspondência de `PATTERN`.

#### PATTERN

Tipo: `string`

Um padrão de expressão regular.

Esse padrão deve ser uma expressão regular Java. Literais de string não são escapados. Por exemplo, para corresponder a `'\abc'`, uma expressão regular seria `'^\\abc$'`.

Consulte a [Tabela de padrões RegEx](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/TransformationFunctions/regular-expressions/regular-expressions.htm#regular-expression-patterns) para obter mais informações.

#### REPLACEMENT

Tipo: `string`

A cadeia de caracteres usada para substituir as instâncias de `PATTERN` encontradas em `STRING`.

[Grupos de captura](http://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html#cg) podem ser referenciados em `REPLACEMENT` usando `$g` para um grupo numerado ou `${name}` para um grupo nomeado. Um cifrão (`$`) pode ser incluído na substituição escapando-o com uma barra invertida (`\$`):

## Retorna

Tipo: `string`

`STRING` com cada instância da subcadeia correspondente à expressão regular `PATTERN` substituída por `REPLACEMENT`.

***

## Exemplos

| STRING | PATTERN | REPLACEMENT | Saída |
| --- | --- | --- | --- |
| 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` |