• INCRBY key increment
    • 返回值
    • 代码示例

    INCRBY key increment

    可用版本： >= 1.0.0
    时间复杂度： O(1)

    为键 key 储存的数字值加上增量 increment 。

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

    如果键 key 储存的值不能被解释为数字，那么 INCRBY 命令将返回一个错误。

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

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

    返回值

    在加上增量 increment 之后，键 key 当前的值。

    代码示例

    键存在，并且值为数字：

    1. redis> SET rank 50
    2. OK
    3.  
    4. redis> INCRBY rank 20
    5. (integer) 70
    6.  
    7. redis> GET rank
    8. "70"

    键不存在：

    1. redis> EXISTS counter
    2. (integer) 0
    3.  
    4. redis> INCRBY counter 30
    5. (integer) 30
    6.  
    7. redis> GET counter
    8. "30"

    键存在，但值无法被解释为数字：

    1. redis> SET book "long long ago..."
    2. OK
    3.  
    4. redis> INCRBY book 200
    5. (error) ERR value is not an integer or out of range