# REGEXP\_EXTRACT

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

## Синтаксис

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

## Аргументы

| Имя | Тип |
| --- | --- |
| string | string |
| образец | string |
| group | numeric |

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

Когда аргумент group исключен, эта функция возвращает первую подстроку, соответствующую шаблону регулярного выражения в строке.

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

***

## Примеры

| string | образец | group | выходные данные |
| --- | --- | --- | --- |
| '1a 2b 14m' | '\d+' |  | '1' |
| 'document.pdf' | '.([^.]+)$' |  | '.pdf' |
| 'john.doe@example.com' | '(?<=@).+$' |  | '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' |