Redis Sorted Sets – ZRANGE命令

2020年8月9日18:58:46 评论 39

ZRANGE key start stop [WITHSCORES]

返回存储在有序集合key中的指定范围的元素。 返回的元素可以认为是按得分从最低到最高排列。 如果得分相同,将按字典排序。

当你需要元素从最高分到最低分排列时,请参阅ZREVRANGE(相同的得分将使用字典倒序排序)。

参数startstop都是基于零的索引,即0是第一个元素,1是第二个元素,以此类推。 它们也可以是负数,表示从有序集合的末尾的偏移量,其中-1是有序集合的最后一个元素,-2是倒数第二个元素,等等。

startstop都是全包含的区间,因此例如ZRANGE myzset 0 1将会返回有序集合的第一个和第二个元素。

超出范围的索引不会产生错误。 如果start参数的值大于有序集合中的最大索引,或者start > stop,将会返回一个空列表。 如果stop的值大于有序集合的末尾,Redis会将其视为有序集合的最后一个元素。

可以传递WITHSCORES选项,以便将元素的分数与元素一起返回。这样,返回的列表将包含value1,score1,...,valueN,scoreN,而不是value1,...,valueN。 客户端类库可以自由地返回更合适的数据类型(建议:具有值和得分的数组或记录)。

返回值

array-reply:给定范围内的元素列表(如果指定了WITHSCORES选项,将同时返回它们的得分)。

例子

ZADD myzset 1 "one"
ZADD myzset 2 "two"
ZADD myzset 3 "three"
ZRANGE myzset 0 -1
ZRANGE myzset 2 3
ZRANGE myzset -2 -1

以下例子使用WITHSCORES展示了该命令如何始终返回一个数组,但这次填充了element_1score_1element_2score_2, …, element_Nscore_N

ZRANGE myzset 0 1 WITHSCORES

相关参考链接

Sorted Sets相关命令:

命令组 命令
Sorted Sets(有序集合) BZPOPMAX;   BZPOPMIN;
ZADD;   ZCARD;   ZCOUNT;   ZINCRBY;   ZINTERSTORE;
ZLEXCOUNT;   ZPOPMAX;   ZPOPMIN;
ZRANGE;   ZRANGEBYLEX;   ZRANGEBYSCORE;
ZRANK;   ZREM;   ZREMRANGEBYLEX;
ZREMRANGEBYRANK;   ZREMRANGEBYSCORE;
ZREVRANGE;   ZREVRANGEBYLEX;   ZREVRANGEBYSCORE;
ZREVRANK;    ZSCAN;    ZSCORE;   ZUNIONSTORE;

全部命令组:Keys(键)Strings(字符串)Hashes(哈希表)Lists(列表)Sets(集合)Sorted Sets(有序集合)Pub/Sub(发布/订阅)Scripting(脚本)Server(服务器)Transactions(事物)Geo(地理位置)Cluster(集群)Connection(连接)Streams(流)HyperLogLog

回到总目录:Redis命令参考手册(总目录)

素课网
  • 本文由 发表于 2020年8月9日18:58:46
  • 转载请注明:https://www.suketech.com/8946.html
Redis Cluster – READONLY命令 Redis命令参考

Redis Cluster – READONLY命令

READONLY 起始版本:3.0.0 时间复杂度:O(1) 开启与 Redis Cluster 从节点连接的读请求 通常,从节点将重定向客户端到认证过的主节点,以获取在指定命令中所涉及的哈希槽,然而...
匿名

发表评论

匿名网友 填写信息

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen: