?
Dieses Dokument verwendet PHP-Handbuch für chinesische Websites Freigeben
ZRANGE key start stop [WITHSCORES]
自1.2.0起可用。
時間復雜度: O( log(N)+ M),其中 N 是有序集合中元素的數(shù)量,M 是返回元素的數(shù)量。
返回存儲在的有序集合中指定范圍的元素key
。這些元素被認為是從最低分到最高分排序。字典順序用于得分相同的元素。
當需要從最高到最低分數(shù)排序的元素時(請參閱相同分數(shù)元素的降序排列順序),請參閱 ZREVRANGE。
兩個start
和stop
是基于零的索引,其中0
是第一要素,1
是下一個元素等。它們也可以是負數(shù),表示排序集結尾的偏移量,是排序集-1
的最后一個元素,-2
倒數(shù)第二個元素等等。
start
和stop
是包含范圍,所以例如ZRANGE myzset 0 1
將返回排序集合的第一個元素和第二個元素。
超出范圍的索引不會產生錯誤。如果start
大于有序集合中的最大索引,或者start > stop
返回空列表。如果stop
大于排序集的末尾,則 Redis 會將其視為排序集的最后一個元素。
可以傳遞WITHSCORES
選項以將元素的分數(shù)與元素一起返回。返回的列表將包含value1,score1,...,valueN,scoreN
而不是value1,...,valueN
??蛻舳藥炜梢宰杂煞祷馗线m的數(shù)據(jù)類型(建議:具有(值,分數(shù))數(shù)組/元組的數(shù)組)。
數(shù)組回復:指定范圍內的元素列表(可選擇其分數(shù),以防WITHSCORES
給出選項)。
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
顯示了該命令如何總是返回一個數(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"