为哈希表 key
中的域 field
的值加上增量 increment
。
增量也可以为负数,相当于对给定域进行减法操作。
如果 key
不存在,一个新的哈希表被创建并执行 HINCRBY 命令。
如果域 field
不存在,那么在执行命令前,域的值被初始化为 0
。
对一个储存字符串值的域 field
执行 HINCRBY 命令将造成一个错误 ERR ERR hash value is not an integer。
本操作的值被限制在 64 位(bit)有符号数字表示之内。
*返回值
整数: 执行 HINCRBY 命令之后,哈希表 key
中域 field
的值。
*例子
redis>
HSET myhash field 5
(integer) 1redis> HINCRBY myhash field 1
(integer) 6redis> HINCRBY myhash field -1
(integer) 5redis> HINCRBY myhash field -10
(integer) -5