ZRAND成员

语法
ZRANDMEMBER key [count [WITHSCORES]]
从以下位置开始可用:
6.2.0
时间复杂度:
O(N),其中 N 是返回的成员数
ACL 类别:
@read, @sortedset, @slow,

当仅使用key参数,从存储在key.

如果提供的countargument 为正数,则返回一个包含不同元素的数组。 数组的长度为count或排序集的基数 (ZCARD),以较低者为准。

如果使用负数调用count,则行为会发生变化,并且允许该命令多次返回同一元素。 在这种情况下,返回的元素数是指定count.

可选的WITHSCORESmodifier 更改 Reply,使其包含从排序集中随机选择的元素的相应分数。

例子

ZADD dadi 1 uno 2 due 3 tre 4 quattro 5 cinque 6 sei ZRANDMEMBER 爸爸 ZRANDMEMBER 爸爸 ZRANDMEMBER dadi -5 WITHSCORES

传递 count 时的行为规范

countargument 为正值,此命令的行为如下:

  • 不会返回重复的元素。
  • 如果count大于排序集的基数,该命令将仅返回整个排序集,而不返回其他元素。
  • 回复中元素的顺序并不是真正随机的,因此如果需要,由客户端对它们进行随机排序。

count为负值时,行为将发生如下变化:

  • 可以重复元素。
  • 完全count元素,或者如果排序集为空(不存在的键),则返回空数组。
  • 回复中的元素顺序确实是随机的。

RESP2 回复

批量字符串回复:如果没有额外的 count 参数,该命令将返回随机选择的成员,或者在 key 不存在时返回 Nil 回复数组回复:当传递额外的 count 参数时,命令返回一个成员数组,当 key 不存在时返回一个空数组。如果使用 WITHSCORES 修饰符,则回复是排序集中的成员及其分数的列表。

RESP3 回复

批量字符串回复:如果没有额外的 count 参数,该命令将返回随机选择的成员,或者在 key 不存在时返回 Null 回复数组回复:当传递额外的 count 参数时,命令返回一个成员数组,当 key 不存在时返回一个空数组。如果使用 WITHSCORES 修饰符,则回复是排序集中的成员及其分数的列表。
为本页评分
返回顶部 ↑