选择 打开 改范围 完整检索页

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

文档 / 函数百科 / 条件表达式

FUNCTION条件表达式

NULLIF

当value1和value2相等时,NULLIF返回一个空值。

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

条件表达式 引入 9.0(基线) 现存至 20 devel 1 条签名 0 次签名变更

签名数
1 条
引入版本
9.0(基线)
状态
现存
签名变更
未变过
本版来源
本站译文

PostgreSQL 18 手册 · 9.18 条件表达式 官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

签名

PostgreSQL 18 里 NULLIF 的 1 条签名,按上游手册顺序排列。参数名用斜体,类型用弱化色, 之后是返回类型。说明取自本站手册译文:标「沿用」的借用了另一版的译文,标「EN」的本站暂无译文、按英文原文显示。

  1. NULLIF(value1, value2)

    value1value2相等时,NULLIF返回一个空值。 否则它返回value1。 这些可以用于执行前文给出的COALESCE示例的逆操作:

演化历史

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

  1. PostgreSQL 13 ← 12 手册重排

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

签名矩阵

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

存在 不存在

签名 9.09.19.29.39.49.59.61011121314151617181920
NULLIF(value1, value2) 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在 存在

同组函数

函数 签名 主签名 版本变动 最近变更
CONDITIONAL EXPRESSIONS 条件表达式 4 个
COALESCE基线 1 COALESCE(value [, ...])
COALESCE函数返回它的第一个非空参数的值。 现存
GREATEST基线 1 GREATEST(value [, ...])
暂无一句话说明 现存
LEAST基线 1 LEAST(value [, ...])
GREATEST和LEAST函数从一个任意的数字表达式列表里选取最大或者最小的数值。 现存
NULLIF基线 1 NULLIF(value1, value2)
当value1和value2相等时,NULLIF返回一个空值。 现存