Redis Zrange コマンド

Redis ソート済みセット(sorted set)

Redis Zrange は、ソート済みセット内の指定された区間のメンバーを返します。

メンバーの位置は、スコア値の昇順(小さいものから大きいものへ)でソートされます。

同じスコア値を持つメンバーは、辞書順(lexicographical order)で並べられます。

メンバーを

値の降順(大きいものから小さいものへ)で並べるには、ZREVRANGEコマンドを使用してください。

インデックスパラメータ start と stop はどちらも 0 基準です。つまり、0 はソート済みセットの最初のメンバー、1 は 2 番目のメンバーを表し、以下同様に続きます。

負のインデックスも使用できます。-1 は最後のメンバー、-2 は最後から 2 番目のメンバーを表し、以下同様に続きます。

構文

redis Zrange コマンドの基本的な構文は次のとおりです:

redis 127.0.0.1:6379> ZRANGE key start stop [WITHSCORES]

利用可能なバージョン

>= 1.2.0

戻り値

指定した区間内の、スコア値(オプション)付きのソート済みセットメンバーのリスト。

例

redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES             # 显示整个有序集成员
1) "jack"
2) "3500"
3) "tom"
4) "5000"
5) "boss"
6) "10086"

redis 127.0.0.1:6379> ZRANGE salary 1 2 WITHSCORES              # 显示有序集下标区间 1 至 2 的成员
1) "tom"
2) "5000"
3) "boss"
4) "10086"

redis 127.0.0.1:6379> ZRANGE salary 0 200000 WITHSCORES         # 测试 end 下标超出最大下标时的情况
1) "jack"
2) "3500"
3) "tom"
4) "5000"
5) "boss"
6) "10086"

redis > ZRANGE salary 200000 3000000 WITHSCORES                  # 测试当给定区间不存在于有序集时的情况
(empty list or set)

Redis ソート済みセット(sorted set)

その他の拡張