DELEX

根据值或摘要比较有条件地删除指定的键。

语法

DELEX key [IFEQ ifeq-value | IFNE ifne-value | IFDEQ ifdeq-digest | IFDNE ifdne-digest]

引入版本：8.4.0

复杂度摘要：O(1)

根据值或哈希摘要比较有条件地删除指定的键。

必需参数

key

要删除的键的名称。

可选参数

以下选项以键的当前值或 哈希摘要 为删除条件。只能指定一个。

IFEQ ifeq-value

仅当其值等于 ifeq-value 时才删除该键。

IFNE ifne-value

仅当其值不等于ifne-value 时才删除该键。

IFDEQ ifdeq-digest

仅当其哈希摘要等于 ifdeq-digest 时才删除键。

IFDNE ifdne-digest

仅当其哈希摘要不等于 ifdne-digest 时才删除该键。

在 8.4 中，使用上述选项之一时，键必须是字符串类型。如果未指定任何选项，则无论其类型如何，该键都会被删除。

详细说明

哈希摘要{#hash-digest}

哈希摘要是字符串值的固定大小的数字表示，使用 XXH3 哈希算法计算。 Redis 使用此哈希摘要进行高效的比较操作，而无需比较完整的字符串内容。您可以使用 DIGEST 命令检索键的哈希摘要，该命令将其作为十六进制字符串返回，您可以将其与 IFDEQ 和 IFDNE 选项以及 SET 命令的 IFDEQ 和 IFDNE 选项一起使用。

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
✅ 标准 ✅ 主动-主动	✅ 标准 ✅ 主动-主动

返回值

RESP2

以下之一： - 整数回复：如果未删除，则为 0（键不存在或指定的 IFEQ/IFNE/IFDEQ/IFDNE 条件为假）；如果已删除，则为 1。 - 简单错误回复 如果键存在但保存的值不是字符串并且指定了 IFEQ, IFNE, IFDEQ, 或 IFDNE 之一。

RESP3

以下之一： - 整数回复：如果未删除，则为 0（键不存在或指定的 IFEQ/IFNE/IFDEQ/IFDNE 条件为假）；如果已删除，则为 1。 - 简单错误回复 如果键存在但保存的值不是字符串并且指定了 IFEQ, IFNE, IFDEQ, 或 IFDNE 之一。

资料来源：Redis 官方 DELEX 文档；中文内容参考 Redis 文档许可。