# REGEXP\_EXTRACT

文字列内の正規表現パターンに最初に一致するものを検索し、要求されたキャプチャ グループ番号を返します。

## 構文

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

## 引数

| 名前 | 型 |
| --- | --- |
| string | string |
| pattern | string |
| group | numeric |

## 戻り値

group 引数が除外されている場合、この関数は文字列内の正規表現パターンに一致する最初の部分文字列を返します。

group 引数が含まれている場合、この関数は文字列内の正規表現パターンの最初の出現箇所を検索し、キャプチャ グループ番号 group に対応する値を返します。

***

## 例

| string | pattern | group | 出力 |
| --- | --- | --- | --- |
| '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' |