HINCRBY

HINCRBY key field increment

为哈希表 key 中的域 field 的值加上增量 increment 。

增量也可以为负数，相当于对给定域进行减法操作。

如果 key 不存在，一个新的哈希表被创建并执行 HINCRBY 命令。

如果域 field 不存在，那么在执行命令前，域的值被初始化为 0 。

对一个储存字符串值的域 field 执行 HINCRBY 命令将造成一个错误。

本操作的值被限制在 64 位(bit)有符号数字表示之内。

可用版本：

>= 2.0.0

时间复杂度：

O(1)

返回值：

执行 HINCRBY 命令之后，哈希表 key 中域 field 的值。

  1. # increment 为正数
  3. redis> HEXISTS counter page_view    # 对空域进行设置
  4. (integer) 0
  6. redis> HINCRBY counter page_view 200
  7. (integer) 200
  9. redis> HGET counter page_view
  10. "200"
  12. # increment 为负数
  14. redis> HGET counter page_view
  15. "200"
  17. redis> HINCRBY counter page_view -50
  18. (integer) 150
  20. redis> HGET counter page_view
  21. "150"
  23. # 尝试对字符串值的域执行HINCRBY命令
  25. redis> HSET myhash string hello,world       # 设定一个字符串值
  26. (integer) 1
  28. redis> HGET myhash string
  29. "hello,world"
  31. redis> HINCRBY myhash string 1              # 命令执行失败，错误。
  32. (error) ERR hash value is not an integer
  34. redis> HGET myhash string                   # 原值不变
  35. "hello,world"

原文: https://wizardforcel.gitbooks.io/redis-doc/content/ref/58.html