PostgreSQL 16 文档 · 9.10. 枚举支持函数

文档 → PostgreSQL 16

受支持版本：当前版本 (18) / 17 / 16 / 15 / 14

测试与开发版本： 19 / devel

不受支持的版本： 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3

9.10. 枚举支持函数
上一页	上一级	第 9 章函数和操作符	起始页	下一页

9.10. 枚举支持函数 #

对于枚举类型（见第 8.7 节），有些函数可以避免硬编码枚举类型中的特定值，使程序更简洁。这些函数列在表 9.35中。以下示例假定枚举类型按如下方式创建：

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

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

以有序数组返回两个给定枚举值之间的范围。两个值必须来自同一枚举类型。如果第一个参数为 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 或该类型的某个具体值，结果都相同。通常会将这些函数用于表列或函数参数，而不是像示例那样使用硬编码的类型名。

上一页	上一级	下一页
9.9. 日期/时间函数和操作符	起始页	9.11. 几何函数和操作符

译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题请通过上游文档表单反馈给 PostgreSQL 文档维护者。