本文内容为 http://www.redis.io/commands/hincrby 的翻译、注解、例子扩充及其它修改。感谢 Redis 作者 Antirez 为开源社区作出的贡献,本文保证最新、最准、最全以表示对其的敬意。欢迎留言纠错、提示更新或支持。
HINCRBY key field increment

将存储在 key 中的哈希(Hash)对象中的指定字段 field 的值加上增量 increment

Increments the number stored at field in the hash stored at key by increment.

如果键 key 不存在,一个保存了哈希对象的新建将被创建。如果字段 field 不存在,在进行当前操作前,其将被创建,且对应的值被置为 0

If key does not exist, a new key holding a hash is created. If field does not exist the value is set to 0 before the operation is performed.

命令 HINCRBY 所支持的值的范围被限制为 64 位有符号整数(64 bit signed integer)

The range of values supported by HINCRBY is limited to 64 bit signed integers.
  • 在进行增量操作后,字段 field 对应的新值。

    Integer reply: the value at field after the increment operation.
  • 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
  • 版本支持

    2.0.0+

    时间复杂度(Time complexity)

    O(1)