DECR

将键的整数值减一。如果键不存在，则使用 0 作为初始值。

语法

DECR key

引入版本：1.0.0

复杂度摘要：O(1)

将 key 中存储的数字减 1。如果该键不存在，则在执行操作之前将其设置为 0。如果键包含错误类型的值或包含无法表示为整数的字符串，则会返回错误。此操作仅限于 64 位有符号整数。

有关递增/递减操作的更多信息，请参阅 INCR。

必需参数

key

键名称。

示例

redis> SET mykey "10"
OK
redis> DECR mykey
(integer) 9
redis> SET mykey "234293482390480948029348230948"
OK
redis> DECR mykey
(error) value is not an integer or out of range

Redis Software 与 Redis Cloud 兼容性

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

返回值

RESP2

整数回复：键递减后的值。

RESP3

整数回复：键递减后的值。

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