# REGEXP\_REPLACE

Remplace chaque instance de la sous-chaîne correspondant à un modèle d'expression régulière dans la chaîne donnée par un remplacement spécifié.

## Syntaxe

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

## Arguments

#### STRING

Type : `string`

Chaîne dans laquelle est recherchée une correspondance `PATTERN`.

#### PATTERN

Type : `string`

Modèle d'expression régulière.

Ce modèle doit être une expression régulière Java. Les littéraux de chaîne ne sont pas échappés. Par exemple, pour correspondre à `'\abc'`, une expression régulière serait `'^\\abc$'`.

Consultez le [Tableau de modèles RegEx](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/TransformationFunctions/regular-expressions/regular-expressions.htm#regular-expression-patterns) pour plus d'informations.

#### REPLACEMENT

Type : `string`

Chaîne utilisée pour remplacer les instances de `PATTERN` trouvées dans `STRING`.

Les [groupes de capture](http://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html#cg) peuvent être référencés dans `REPLACEMENT` en utilisant `$g` pour un groupe numéroté ou `${name}` pour un groupe nommé. Un signe dollar (`$`) peut être inclus dans le remplacement en l'échappant via une barre oblique inverse (`\$`) :

## Renvoie

Type : `string`

`STRING` avec chaque instance de la sous-chaîne correspondant à l'expression régulière `PATTERN` remplacée par `REPLACEMENT`.

***

## Exemples

| STRING | PATTERN | REPLACEMENT | Sortie |
| --- | --- | --- | --- |
| 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` |