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