ZINCRBY

增加有序集合中成员的分数。

语法

ZINCRBY key increment member

引入版本:1.2.0

复杂度摘要:O(log(N)

将 key 中存储的有序集合中的 member 的分数增加 increment。如果有序集合中不存在 member,则会添加 increment 作为其分数(就好像其之前的分数是 0.0)。如果 key 不存在,则会创建一个新的有序集合,其中指定的 member 作为其唯一成员。

当key存在但不包含有序集时,返回错误。

score 值应该是数值的字符串表示形式,并且接受双精度浮点数。可以提供负值来减少分数。

必需参数

key

保存有序集合的键的名称。

increment

添加到会员当前分数的金额。

member

积分需要增加的会员。如果不存在则以增量作为分数相加。

示例

redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZINCRBY myzset 2 "one"
"3"
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "two"
2) "2"
3) "one"
4) "3"

Redis Software 与 Redis Cloud 兼容性

Redis
软件
Redis
Cloud
说明
✅ 标准
✅ 主动-主动
✅ 标准
✅ 主动-主动

返回值

RESP2

批量字符串回复:会员 的新分数,为双精度浮点数。

RESP3

双重回复:会员 的新分数。

资料来源:Redis 官方 ZINCRBY 文档;中文内容参考 Redis 文档许可。