ЛИНТЕР

Выделение подстроки (SUBSTR/SUBSTRING)

Функция

Выделение подстроки из заданной строки.

Спецификация

Варианты:

<синтаксис>::=
SUBSTR (строка, начало[, длина])
<позиционное выделение подстроки>::=
SUBSTRING (строка [{FROM|,} начало] [{FOR|,} длина])
<выделение подстроки по шаблону>::=
SUBSTRING (строка SIMILAR шаблон ESCAPE ESC-символ)
<шаблон>::=
регулярное выражение1 ESC-символ
"регулярное выражение2 ESC-символ"регулярное выражение3

Общие правила

В качестве <строки> можно использовать выражения типа CHAR, VARCHAR, NCHAR, NCHAR VARYING.
<Длина> подстроки должна задаваться в диапазоне от 0 до N, где N = length(<строка>) - <начало> + 1.
Формат <шаблона> регулярных выражений описан в пункте «Предикат сопоставления».
В вариантах 1 и 2 из <строки> выбирается подстрока заданной <длины>, начиная с позиции <начало>.
Если опция [FROM |, <начало>] не задана, по умолчанию принимается FROM 1. При этом обязательно должно использоваться ключевое слово FOR.
```
select substring('testing' for 4);
|test|
```
Если <длина> не задана, конечная позиция выбираемой подстроки определяется как максимум из двух значений: <начало> и длина <строки>.
Если <начало> больше длины <строки>, или вычисленная конечная позиция меньше 1, возвращается пустая строка.

Длина подстроки не задана:
```
select substring('123456', 5);
|56
```
```
select substring('123456', 10);
|          |
```
Позиция <начала> больше длины <строки>:
```
select length(substring('123456', 8.2));
|          0|
```
Конечная позиция меньше 1:
```
select length(substring('123456', 2,-5));
|          0|
```
По умолчанию подстрока выбирается с позиции <начало> до конца исходной строки.
```
select substring('testing' from 3), substring('testing', 3);
| sting | sting |
```
```
select substring(cast 123456 as char(6), 4);
| 456 |
```
Не целочисленное значение параметров <начало> и <длина> усекается до целого значения.
```
select substring('123456', 5.7);
|56|
```
Конструкция
```
select substr(model, 3, 4) from auto;
```
и
```
select substring(model from 3 for 4) from auto;
```
эквивалентны.
```
| RCUR |
| 310  |
| TADO |
  …
```
Если <длина> не задана, то конечная длина подстроки определяется как максимум из двух значений: <начало> и длина <строки> (в случае типа данных VARCHAR конечным считается последний фактический символ).
```
select substr(model, 3) from auto;
| RCURY COMET GT V8 |
| 310               |
| TADOR STATION     |
…
```
Если <длина> равна 0, возвращается пустая строка.
<ESC-символ> в обязательном аргументе функции задает разделитель шаблона регулярного выражения.

Предположим, что в качестве ESC-символа задан символ "x".

Тогда символьная строка, задаваемая во втором операнде, должна иметь вид '<рег1>"рег2"рег3', где рег1, рег2 и рег3 являются регулярными выражениями.

Функция пытается разделить <строку> на три раздела, первый из которых определяется путем сопоставления начала строки со строками, генерируемыми <рег1>, второй – путем сопоставления оставшейся части <строки> с <рег2>, и третий – путем сопоставления конца этой строки с <рег3>.

В случае отсутствия в <шаблоне> двух пар, состоящих из следующих друг за другом ESC-символа и '"', будет выдан код завершения 1125 («Неверный символ ESCAPE»).
```
select substring('This image is nice' similar 'T%\"i[[:alpha:]]+e\"%is [[:alnum:]]+' escape '\');
```
Результатом будет строка 'image'.
```
select substring('This is string22' similar 'This is \"[[:ALPHA:]]+\"[[:DIGIT:]]+' escape '\');
```
Результатом будет строка 'string'.
Все аргументы функции могут быть заданы <SQL-параметром>, который должен содержать спецификацию типа данных параметра.
```
select substr (? (char(20)), ? (int), ? (double));
select substring (? (char(20)) from  ? (int) for ? (double));
Тестовая строка
10
3.67
|стр                 |
```

Возвращаемое значение

Возвращается либо подстрока заданной <длины>, либо подстрока с символами от позиции <начала> до конца <строки>, дополненная справа пробелами до заданной <длины>.
В случае использования регулярного выражения возвращается средняя часть <строки>.
Если тип данных <строки> CHAR, тип результата CHAR.
Если тип данных <строки> VARCHAR, тип результата VARCHAR.
Если значение хотя бы одного из операндов не определено (NULL) или если <строка> не подходит по <шаблону>, возвращается NULL-значение.
Если в качестве второго или третьего параметра указано отрицательное значение, возвращается код завершения 1036 - Значение аргумента в недопустимом диапазоне.

Пример

create table tab1 (c char(20));
insert into tab1 values(user);
insert into tab1 values('Систем');
select c,
       user as "user",
       substr(user, case instr(c, 'SYS')
                      when 0 then 4
                      else instr(c, 'SYS') end, 2) as "substr"
  from tab1;

| C      | User   | Substr |
| SYSTEM | SYSTEM | SY     |
| Систем | SYSTEM | TE     |