*Redis ZRANGEBYSCORE 命令 按分数范围返回成员(已弃用,推荐 ZRANGE)

*语法

ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]

*说明

返回有序集合中 score 在 minmax 之间(包含边界)的所有成员。

⚠️ 弃用提示:从 Redis 6.2 开始已弃用,推荐使用 ZRANGE key min max BYSCORE

score 范围格式

  • 可以使用 ( 表示不包含边界,如 (5 表示大于 5
  • -inf+inf 表示负无穷和正无穷

*返回值

  • 数组:score 在指定范围内的成员列表

*时间复杂度

  • O(log(N)+M),其中 N 是集合成员总数,M 是返回的成员数量。

*版本兼容性

Redis 版本 变更说明
>= 1.0.5 可用
>= 6.2.0 已弃用,请使用 ZRANGE ... BYSCORE

*示例

redis-cli ZADD myzset 1 "one" 2 "two" 3 "three" 4 "four" 5 "five"

# 旧语法(已弃用)
redis-cli ZRANGEBYSCORE myzset 2 4

# 推荐新语法
redis-cli ZRANGE myzset 2 4 BYSCORE

# 带 score 返回
redis-cli ZRANGE myzset 2 4 BYSCORE WITHSCORES

# 不包含边界
redis-cli ZRANGE myzset (2 (4 BYSCORE

# 分页
redis-cli ZRANGE myzset 0 100 BYSCORE LIMIT 0 2