?
This document uses PHP Chinese website manual Release
ZRANGE key start stop [WITHSCORES]
自1.2.0起可用。
時(shí)間復(fù)雜度: O( log(N)+ M),其中 N 是有序集合中元素的數(shù)量,M 是返回元素的數(shù)量。
返回存儲(chǔ)在的有序集合中指定范圍的元素key
。這些元素被認(rèn)為是從最低分到最高分排序。字典順序用于得分相同的元素。
當(dāng)需要從最高到最低分?jǐn)?shù)排序的元素時(shí)(請(qǐng)參閱相同分?jǐn)?shù)元素的降序排列順序),請(qǐng)參閱 ZREVRANGE。
兩個(gè)start
和stop
是基于零的索引,其中0
是第一要素,1
是下一個(gè)元素等。它們也可以是負(fù)數(shù),表示排序集結(jié)尾的偏移量,是排序集-1
的最后一個(gè)元素,-2
倒數(shù)第二個(gè)元素等等。
start
和stop
是包含范圍,所以例如ZRANGE myzset 0 1
將返回排序集合的第一個(gè)元素和第二個(gè)元素。
超出范圍的索引不會(huì)產(chǎn)生錯(cuò)誤。如果start
大于有序集合中的最大索引,或者start > stop
返回空列表。如果stop
大于排序集的末尾,則 Redis 會(huì)將其視為排序集的最后一個(gè)元素。
可以傳遞WITHSCORES
選項(xiàng)以將元素的分?jǐn)?shù)與元素一起返回。返回的列表將包含value1,score1,...,valueN,scoreN
而不是value1,...,valueN
??蛻舳藥?kù)可以自由返回更合適的數(shù)據(jù)類型(建議:具有(值,分?jǐn)?shù))數(shù)組/元組的數(shù)組)。
數(shù)組回復(fù):指定范圍內(nèi)的元素列表(可選擇其分?jǐn)?shù),以防WITHSCORES
給出選項(xiàng))。
redis> ZADD myzset 1 "one" (integer) 1
redis> ZADD myzset 2 "two" (integer) 1
redis> ZADD myzset 3 "three" (integer) 1
redis> ZRANGE myzset 0 -1 1) "one" 2) "two" 3) "three"
redis> ZRANGE myzset 2 3 1) "three"
redis> ZRANGE myzset -2 -1 1) "two" 2) "three"
以下示例WITHSCORES
顯示了該命令如何總是返回一個(gè)數(shù)組,但這次使用 element_1 ,score_1 ,element_2 ,score_2 ,... ,element_N ,score_N 填充。
redis> ZRANGE myzset 0 1 WITHSCORES 1) "one" 2) "1" 3) "two" 4) "2"