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 文档许可。