ДОКУМЕНТАЦИЯ

Выберите версию, форк и язык для СУБД Digital Q.DataBase, чтобы прочитать или скачать всю документацию.

Новости

01.09.2026

СУБД Digital Q.DataBase можно развернуть из готового Docker-образа

25.08.2026

СУБД Digital Q.DataBase: 8 ядер бесплатно — до 1 сентября!

Документация

Диасофт
Авторские права © 2016–2025 ООО "Диасофт Экосистема"

Скачать всю документацию:

pdf (13 mБ) EPUB (13 mБ) CHM (14 МБ)

2.6.10. Функции поддержки перечисляемых типов

Содержание

Для перечисляемых типов (описанных в Раздел 2.5.7), предусмотрено несколько функций, позволяющих повысить чистоту программного кода без жесткого кодирования конкретных значений перечисляемого типа. Данные функции перечислены в Таблица 2.6.35. В примерах предполагается, что перечисляемый тип создан следующим образом:

CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple');

Таблица 2.6.35. Функции поддержки перечисляемых типов

Функция Описание Примеры
`enum_first` ( `anyenum` ) → `anyenum` Функция возвращает первое значение входного перечисляемого типа. `enum_first(null::rainbow)` → `red`
`enum_last` ( `anyenum` ) → `anyenum` Функция возвращает последнее значение входного перечисляемого типа. `enum_last(null::rainbow)` → `purple`
`enum_range` ( `anyenum` ) → `anyarray` Функция возвращает все значения входного перечисляемого типа в виде упорядоченного массива. `enum_range(null::rainbow)` → `{red,orange,yellow,green,blue,purple}`
`enum_range` ( `anyenum`, `anyenum` ) → `anyarray` Функция возвращает диапазон между двумя заданными значениями перечисления в виде упорядоченного массива. Все значения должны принадлежать к одному и тому же перечисляемому типу (enum). Если первый параметр равен null, то возвращаемый диапазон начнется с первого значения этого перечисляемого типа. Если второй параметр равен null, то возвращаемый диапазон завершится последним значением этого перечисляемого типа. `enum_range('orange'::rainbow, 'green'::rainbow)` → `{orange,yellow,green}` `enum_range(NULL, 'green'::rainbow)` → `{red,orange,yellow,green}` `enum_range('orange'::rainbow, NULL)` → `{orange,yellow,green,blue,purple}`

Функция

Описание

Примеры

enum_first ( anyenum ) → anyenum

Функция возвращает первое значение входного перечисляемого типа.

enum_first(null::rainbow) → red

enum_last ( anyenum ) → anyenum

Функция возвращает последнее значение входного перечисляемого типа.

enum_last(null::rainbow) → purple

enum_range ( anyenum ) → anyarray

Функция возвращает все значения входного перечисляемого типа в виде упорядоченного массива.

enum_range(null::rainbow) → {red,orange,yellow,green,blue,purple}

enum_range ( anyenum, anyenum ) → anyarray

Функция возвращает диапазон между двумя заданными значениями перечисления в виде упорядоченного массива. Все значения должны принадлежать к одному и тому же перечисляемому типу (enum). Если первый параметр равен null, то возвращаемый диапазон начнется с первого значения этого перечисляемого типа. Если второй параметр равен null, то возвращаемый диапазон завершится последним значением этого перечисляемого типа.

enum_range('orange'::rainbow, 'green'::rainbow) → {orange,yellow,green}

enum_range(NULL, 'green'::rainbow) → {red,orange,yellow,green}

enum_range('orange'::rainbow, NULL) → {orange,yellow,green,blue,purple}

Следует отметить, что за исключением формы функции enum_range, принимающей два аргумента, данные функции игнорируют конкретное переданное им значение; они учитывают только объявленный тип данных этого значения. Для получения одного и того же результата можно передать как значение null, так и конкретное значение указанного типа. Как правило, данные функции применяются к столбцу таблицы или аргументу функции, а не к жестко заданному имени типа, как показано в примерах.

Наверх