INCRBY

INCRBY key increment

将 key 所储存的值加上增量 increment 。

如果 key 不存在，那么 key 的值会先被初始化为 0 ，然后再执行 INCRBY 命令。

如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。

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

关于递增(increment) / 递减(decrement)操作的更多信息，参见 INCR 命令。

可用版本：

>= 1.0.0

时间复杂度：

O(1)

返回值：

加上 increment 之后， key 的值。

  1. # key 存在且是数字值
  3. redis> SET rank 50
  4. OK
  6. redis> INCRBY rank 20
  7. (integer) 70
  9. redis> GET rank
  10. "70"
  12. # key 不存在时
  14. redis> EXISTS counter
  15. (integer) 0
  17. redis> INCRBY counter 30
  18. (integer) 30
  20. redis> GET counter
  21. "30"
  23. # key 不是数字值时
  25. redis> SET book "long long ago..."
  26. OK
  28. redis> INCRBY book 200
  29. (error) ERR value is not an integer or out of range

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