HINCRBY

将哈希中字段的整数值增加一个数字。如果该字段不存在，则使用 0 作为初始值。

语法

HINCRBY key field increment

引入版本：2.0.0

复杂度摘要：O(1)

将存储在 key 处的哈希中存储在 field 处的数字增加 increment。如果 key 不存在，则会创建一个包含哈希值的新键。如果 field 不存在，则在执行操作之前将值设置为 0。

HINCRBY 支持的值范围仅限于 64 位有符号整数。

必需参数

key

保存哈希值的键的名称。

field

其值要增加的字段。

increment

要添加到字段值的整数金额。

示例

由于 increment 参数是带符号的，因此可以执行递增和递减操作：

redis> HSET myhash field 5
(integer) 1
redis> HINCRBY myhash field 1
(integer) 6
redis> HINCRBY myhash field -1
(integer) 5
redis> HINCRBY myhash field -10
(integer) -5

Redis Software 与 Redis Cloud 兼容性

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

返回值

RESP2

整数回复：自增操作后该字段的值。

RESP3

整数回复：自增操作后该字段的值。

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