Redis ZINCRBY 命令为有序集合 key 的成员 member 的 score 值加上增量 increment。
命令格式
ZINCRBY key increment member
可用版本:>=1.2.0
时间复杂度:O(log(N)),N 为有序集合的基数(即成员的个数)
可以通过传递一个负数值 increment,让 score 减去相应的值,比如 ZINCRBY key -5 member
,就是让 member 的 score 值减去 5。
当 key 不存在,或 member 不是 key 的成员时,ZINCRBY key increment member
等同于 ZADD key increment member
。
当 key 不是有序集合类型时,返回一个错误。
score 值可以是整数值或双精度浮点数。
命令返回值
返回 member 成员的新 score 值,以字符串形式表示。
示例
redis> ZADD myzset 1 member_one
(integer) 1
redis> ZADD myzset 2 member_two
(integer) 1
redis> ZINCRBY myzset 9 member_one
"10"
redis> ZINCRBY myzset -0.5 member_two
"1.5"
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "member_two"
2) "1.5"
3) "member_one"
4) "10"