FUNCTION条件表达式

NULLIF

当 value1 和 value2 相等时，NULLIF 返回 null。否则它返回 value1。这可以用于执行前文给出的 COALESCE 示例的逆操作：

The NULLIF function returns a null value if value1 equals value2; otherwise it returns value1.

条件表达式引入 7.1（基线）现存至 20 devel 1 条签名 0 次签名变更

版本轨迹

相对 PostgreSQL 17 无变化。

当 value1 和 value2 相等时，NULLIF 返回 null。否则它返回 value1。这可以用于执行前文给出的 COALESCE 示例的逆操作：

NULLIF(value1, value2)

当 value1 和 value2 相等时，NULLIF 返回 null。否则它返回 value1。这可以用于执行前文给出的 COALESCE 示例的逆操作：

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

NULLIF(value1, value2)

当 value1 和 value2 相等时，NULLIF 返回 null。否则它返回 value1。这可以用于执行前文给出的 COALESCE 示例的逆操作：

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

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

存在不存在

签名	7.1	7.2	7.3	7.4	8.0	8.1	8.2	8.3	8.4	9.0	9.1	9.2	9.3	9.4	9.5	9.6	10	11	12	13	14	15	16	17	18	19	20
`NULLIF(value1, value2)`	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在	存在

函数	签名	主签名	最近变更
CONDITIONAL EXPRESSIONS 条件表达式 4 个 ↗
`COALESCE`基线	1	`COALESCE(value [, ...])`	7.31 次
COALESCE 函数返回参数中第一个不为 null 的值。只有所有参数都为 null 时，才返回 null。它常用于在检索数据以供显示时，用默认值替换 null 值。例如：			现存
`GREATEST`	1	`GREATEST(value [, ...])`	—
GREATEST 和 LEAST 函数从由任意数量的表达式组成的列表中选取最大值或最小值。这些表达式都必须能转换为同一个数据类型，该类型将作为结果类型（详情参见第 10.5 节）。			现存
`LEAST`	1	`LEAST(value [, ...])`	—
GREATEST 和 LEAST 函数从由任意数量的表达式组成的列表中选取最大值或最小值。这些表达式都必须能转换为同一个数据类型，该类型将作为结果类型（详情参见第 10.5 节）。			现存
`NULLIF`基线	1	`NULLIF(value1, value2)`	—
当 value1 和 value2 相等时，NULLIF 返回 null。否则它返回 value1。这可以用于执行前文给出的 COALESCE 示例的逆操作：			现存