Redis 基础教程

Redis 命令

Redis 高级教程

Redis 笔记

original icon
版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.knowledgedict.com/tutorial/redis-command-zincrby.html

Redis ZINCRBY 命令

Redis 有序集合 Redis 有序集合


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"