INCRBY
Redis手册 / 字符串
INCRBY key increment
可用版本: >= 1.0.0
时间复杂度: O(1)
为键 key 储存的数字值加上增量 increment 。
如果键 key 不存在, 那么键 key 的值会先被初始化为 0 , 然后再执行 INCRBY 命令。
如果键 key 储存的值不能被解释为数字, 那么 I`NCRBY 命令将返回一个错误。
本操作的值限制在 64 位(bit)有符号数字表示之内。
关于递增(increment) / 递减(decrement)操作的更多信息, 请参见 INCR 命令的文档。
返回值
在加上增量 increment 之后, 键 key 当前的值。
代码示例
键存在,并且值为数字: 1redis> SET rank 502OK3 4redis> INCRBY rank 205(integer) 706 7redis> GET rank8"70"
键不存在:
1redis> EXISTS counter2(integer) 03 4redis> INCRBY counter 305(integer) 306 7redis> GET counter8"30"
键存在,但值无法被解释为数字:
1OK2 3redis> INCRBY book 2004(error) ERR value is not an integer or out of range```