ZRAND成员
语法
ZRANDMEMBER key [count [WITHSCORES]]
- 从以下位置开始可用:
- 6.2.0
- 时间复杂度:
- O(N),其中 N 是返回的成员数
- ACL 类别:
-
@read
,@sortedset
,@slow
,
当仅使用key
参数,从存储在key
.
如果提供的count
argument 为正数,则返回一个包含不同元素的数组。
数组的长度为count
或排序集的基数 (ZCARD
),以较低者为准。
如果使用负数调用count
,则行为会发生变化,并且允许该命令多次返回同一元素。
在这种情况下,返回的元素数是指定count
.
可选的WITHSCORES
modifier 更改 Reply,使其包含从排序集中随机选择的元素的相应分数。
例子
传递 count 时的行为规范
当count
argument 为正值,此命令的行为如下:
- 不会返回重复的元素。
- 如果
count
大于排序集的基数,该命令将仅返回整个排序集,而不返回其他元素。 - 回复中元素的顺序并不是真正随机的,因此如果需要,由客户端对它们进行随机排序。
当count
为负值时,行为将发生如下变化:
- 可以重复元素。
- 完全
count
元素,或者如果排序集为空(不存在的键),则返回空数组。 - 回复中的元素顺序确实是随机的。