PostgreSQL 中文参考文档
🌐 英文原版 官方 ↗

9.10. 枚举支持函数 #

对于枚举类型 (在 Section 8.7 中描述), 有若干函数允许以更干净的方式编程, 而无需硬编码某个枚举类型的特定值。 它们列在 Table 9.35 中。 例子假设存在一个如下创建的枚举类型:

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

Table 9.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_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 的双参数形式之外, 这些函数都会忽略传递给它们的具体值; 它们只关心其声明的数据类型。 传递空值或该类型的一个特定值都可以, 结果相同。 与例子中使用的硬编码类型名相比, 更常见的做法是把这些函数应用到一个表列或函数参数上。