BZPOPMIN key [key ...] timeout

Redis BZPOPMIN 命令是有序集合命令 ZPOPMIN带有阻塞功能的版本。

在参数中的所有有序集合均为空的情况下,阻塞连接。参数中包含多个有序集合时,按照参数中 key 的顺序,返回第一个非空 key 中分数最小的成员和对应的分数。

参数 timeout 可以理解为客户端被阻塞的最大秒数值,0 表示永久阻塞。

详细说明请参照 BLPOP 说明文档BZPOPMIN 适用有序集合类型的 key,BLPOP 适用列表类型的 key,除此之外,两条命令无其他差别。

*语法

redis BZPOPMIN 命令基本语法如下:

redis 127.0.0.1:6379> BZPOPMIN key [key ...] timeout

*返回值

数组: specifically:

  • 当有序集合空且执行超时时返回 nil
  • 返回三元素结果,第一元素 key 名称,第二元素成员名称,第三元素分数。

*历史

  • >= 6.0: timeout 从整型变为 double 类型。

*例子

redis> DEL zset1 zset2
(integer) 0
redis> ZADD zset1 0 a 1 b 2 c
(integer) 3
redis> BZPOPMIN zset1 zset2 0
1) "zset1"
2) "a"
3) "0"