# REGEXP\_EXTRACT

Encontra a primeira correspondência do padrão de expressão regular na string e retorna o número do grupo de captura solicitado.

## Sintaxe

```
REGEXP_EXTRACT(string, pattern, group)
```

## Argumentos

| Nome | Tipo |
| --- | --- |
| caractere | caractere |
| padrão | caractere |
| group | numérico |

## Retorna

Quando o argumento group é excluído, esta função retorna a primeira substring correspondida pelo padrão de expressão regular na string.

Se o argumento group for incluído, a função encontrará a primeira ocorrência do padrão de expressão regular na string e retornará o número do grupo de captura group.

***

## Exemplos

| caractere | padrão | group | saída |
| --- | --- | --- | --- |
| '1a 2b 14m' | '\d+' |  | '1' |
| 'document.pdf' | '.([^.]+)$' |  | '.pdf' |
| 'john.doe@example.com' | '(?&lt;=@).+$' |  | 'example.com' |
| '1a 2b 14m' | '' |  | '' |
| '1a 2b 14m' | 'c' |  | NULL |
| '1a 2b 14m' | '(1a' |  | NULL |
| '1a 2b 14m' | '(\d+)([a-z]+)' | '2' | 'a' |
| '1a 2b 14m' | '(\d+)([a-z]+)' | '1' | '1' |
| '1a 2b 14m' | '(\d+)([a-z]+)' | '0' | '1a' |