↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / 函数百科 / 枚举支持函数

FUNCTION枚举支持函数

enum_range

将输入枚举类型的所有值作为一个有序的数组返回。

Returns all values of the input enum type in an ordered array.

枚举支持函数 引入 8.3 现存至 20 devel 2 条签名 0 次签名变更

签名数
2 条
引入版本
8.3
状态
现存
签名变更
未变过
本版来源
同版手册译文

PostgreSQL 18.7 手册 · 9.10 枚举支持函数 官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

说明

将输入枚举类型的所有值作为一个有序的数组返回。
enum_range ( anyenum ) → anyarray
将输入枚举类型的所有值作为一个有序的数组返回。
enum_range ( anyenum, anyenum ) → anyarray
以有序数组返回两个给定枚举值之间的范围。两个值必须来自同一枚举类型。如果第一个参数为 null,结果从该枚举类型的第一个值开始;如果第二个参数为 null,结果以该枚举类型的最后一个值结束。

签名

PostgreSQL 18.7 里 enum_range 的 2 条签名,按上游手册顺序排列。参数名用斜体,类型用弱化色, 之后是返回类型。中文说明来自同版本手册与审阅译文,悬停可查看每条说明的来源。

  1. enum_range ( anyenum ) → anyarray

    将输入枚举类型的所有值作为一个有序的数组返回。
    • enum_range(null::rainbow){red,orange,yellow,​green,blue,purple}
  2. enum_range ( anyenum, anyenum ) → anyarray

    以有序数组返回两个给定枚举值之间的范围。两个值必须来自同一枚举类型。如果第一个参数为 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}

演化历史

相邻两个大版本之间的差异,新的在前。版本号链到该版的签名。

  1. PostgreSQL 13 ← 12 手册重排

    这一跳手册重排了函数表的写法,签名文本整体改写,只记函数的增删,不逐条比较签名。

  2. PostgreSQL 8.3 ← 8.2 新增此函数

    PostgreSQL 8.3 起可用

签名矩阵

每条签名在给出了签名的 20 个版本里的存在情况;方格指向该版的签名。只在正文里提到此函数、没有给出签名的版本不列进来,上面的版本轨迹里仍然有它们。签名文本在 PostgreSQL 13 前后写法不同,跨越那一跳的同一条签名会显示成两行。

存在 不存在

签名 8.38.49.09.19.29.39.49.59.61011121314151617181920
enum_range ( anyenum ) 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在
enum_range ( anyenum, anyenum ) 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在
enum_range ( NULL, 'green'::rainbow ) 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在
enum_range ( 'orange'::rainbow, NULL ) 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在
enum_range ( anyenum ) → anyarray 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 存在 存在 存在 存在 存在 存在 存在 存在
enum_range ( anyenum, anyenum ) → anyarray 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 不存在 存在 存在 存在 存在 存在 存在 存在 存在

同组函数

函数 签名 主签名 版本变动 最近变更
ENUM SUPPORT FUNCTIONS 枚举支持函数 3 个 ↗
enum_first 1 enum_first ( anyenum ) → anyenum —
返回输入枚举类型的第一个值。 现存
enum_last 1 enum_last ( anyenum ) → anyenum —
返回输入枚举类型的最后一个值。 现存
enum_range 2 enum_range ( anyenum ) → anyarray —
将输入枚举类型的所有值作为一个有序的数组返回。 现存