Redis INCRBY 命令

Redis 字符串(String)

Redis INCRBY 命令将 key 中储存的数字加上指定的增量值。

 

1. 语法

redis INCRBY 命令基本语法如下：

INCRBY KEY_NAME INCR_AMOUNT

 

2. 可用版本

>= 1.0.0

 

3. 返回值

加上指定的增量值之后的 key 值。

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

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

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

 

4. 范例

# key 存在且是数字值

redis 127.0.0.1:6379> SET rank 50
OK

redis 127.0.0.1:6379> INCRBY rank 20
(integer) 70

redis 127.0.0.1:6379> GET rank
"70"

# key 不存在时

redis 127.0.0.1:6379> EXISTS counter
(integer) 0

redis 127.0.0.1:6379> INCRBY counter 30
(integer) 30

redis 127.0.0.1:6379> GET counter
"30"


# key 不是数字值时
redis 127.0.0.1:6379> SET book "A dream of red mansions"
OK

redis 127.0.0.1:6379> INCRBY book 200
(error) ERR value is not an integer or out of range

Redis 字符串(String)

Redis INCRBYFLOAT 命令为 key 中所储存的值加上指定的浮点数增量值。如果 key 不存在，那么 INCRBYFLOAT 会先将 key 的值设为 0 ，再执行加法操作。语法：redis INCRBYFLOAT 命令基本语法如下：INCRBYFLOAT KEY_NAME INCR_AMOUNT。