ZRANGE
Syntax
ZRANGE key start stop [BYSCORE | BYLEX] [REV] [LIMIT offset count] [WITHSCORES]
- Available since:
- 1.2.0
- Time complexity:
- O(log(N)+M) with N being the number of elements in the sorted set and M the number of elements returned.
- ACL categories:
-
@read,@sortedset,@slow,
返回存储在
ZRANGE 可以执行不同类型的范围查询：按索引（排名）、按分数或按字典顺序。
从 Redis 6.2.0 开始，此命令可以替换以下命令：ZREVRANGE、ZRANGEBYSCORE、ZREVRANGEBYSCORE、ZRANGEBYLEX 和 ZREVRANGEBYLEX。
常见行为和选项
元素的顺序是从最低分到最高分。具有相同分数的元素按字典顺序排列。
可选的 REV 参数会反转排序顺序，因此元素会从最高分到最低分排序，分数相同的情况下会按反向字典顺序解决。
可选的LIMIT参数可用于从匹配元素中获取子范围（类似于SQL中的SELECT LIMIT offset, count）。
负数的
可选的 WITHSCORES 参数通过返回元素的分数来补充命令的回复。返回的列表包含 value1,score1,...,valueN,scoreN 而不是 value1,...,valueN。客户端库可以自由返回更合适的数据类型（建议：一个包含（值，分数）数组/元组的数组）。
索引范围
默认情况下，该命令执行索引范围查询。0 是第一个元素，1 是下一个元素，依此类推。这些参数指定了一个包含范围，因此例如，ZRANGE myzset 0 1 将返回有序集合中的第一个和第二个元素。
索引也可以是负数，表示从排序集合末尾开始的偏移量，其中-1表示排序集合的最后一个元素，-2表示倒数第二个元素，依此类推。
超出范围的索引不会产生错误。
如果
如果
分数范围
当提供BYSCORE选项时，该命令的行为类似于ZRANGEBYSCORE，并返回排序集合中分数等于或介于
-inf 和 +inf，分别表示负无穷和正无穷。这意味着你不需要知道排序集合中的最高或最低分数来获取从某个分数开始或到某个分数的所有元素。
默认情况下，由(来指定开区间（不包含端点）。
例如：
ZRANGE zset (1 5 BYSCORE
将返回所有满足 1 < score <= 5 的元素，同时：
ZRANGE zset (5 (10 BYSCORE
将返回所有5 < score < 10（不包括5和10）的元素。
反向范围
使用REV选项可以反转排序集合，索引0为得分最高的元素。
默认情况下，BYSCORE 或 BYLEX 选项，
例如：
ZRANGE zset 5 10 REV
将返回反转索引中索引5到10之间的元素。
ZRANGE zset 10 5 REV BYSCORE
将返回所有分数小于10且大于5的元素。
词典范围
当使用BYLEX选项时，该命令的行为类似于ZRANGEBYLEX，并返回排序集合中在
请注意，字典序排序依赖于所有元素具有相同的分数。当元素具有不同的分数时，回复是未指定的。
有效的 ( 或 [ 开头，以便分别指定范围区间是排他的还是包含的。
+ 或 - 分别表示正无穷和负无穷的字符串，因此例如命令 ZRANGE myzset - + BYLEX 保证会返回有序集合中的所有元素，前提是所有元素的分数相同。
REV 选项会反转
字符串的字典序比较
字符串被比较为字节的二进制数组。由于ASCII字符集的指定方式，这通常意味着以明显的字典方式比较普通ASCII字符。然而，如果使用非纯ASCII字符串（例如，utf8字符串），则情况并非如此。
然而，用户可以应用一个转换到编码字符串上，以便插入到排序集合中的元素的第一部分将按照用户对特定应用程序的要求进行比较。例如，如果我想添加将以不区分大小写的方式进行比较的字符串，但我仍然希望在查询时检索到真实的大小写，我可以以下列方式添加字符串：
ZADD autocomplete 0 foo:Foo 0 bar:BAR 0 zap:zap
由于每个元素中的第一个标准化部分（在冒号字符之前），我们强制进行给定的比较。然而，在使用ZRANGE ... BYLEX查询范围后，应用程序可以向用户显示冒号后的字符串的第二部分。
比较的二进制性质允许使用排序集作为通用索引，例如，元素的第一部分可以是一个64位的大端数。由于大端数在初始位置具有最高有效字节，二进制比较将匹配数字的数值比较。这可以用于实现对64位值的范围查询。如下例所示，在前8个字节之后，我们可以存储我们正在索引的元素的值。
示例
> ZADD myzset 1 "one" 2 "two" 3 "three"
(integer) 3
> ZRANGE myzset 0 -1
1) "one"
2) "two"
3) "three"
> ZRANGE myzset 2 3
1) "three"
> ZRANGE myzset -2 -1
1) "two"
2) "three"Are you tired of using redis-cli? Try Redis Insight - the developer GUI for Redis.
import redis
r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
res = r.zadd("myzset", {"one": 1})
print(res)
# >>> 1
res = r.zadd("myzset", {"uno": 1})
print(res)
# >>> 1
res = r.zadd("myzset", {"two": 2, "three": 3})
print(res)
# >>> 2
res = r.zrange("myzset", 0, -1, withscores=True)
# >>> [('one', 1.0), ('uno', 1.0), ('two', 2.0), ('three', 3.0)]
res = r.zadd("myzset", {"one": 1, "two":2, "three":3})
print(res)
# >>> 3
res = r.zrange("myzset", 0, -1)
print(res)
# >>> ['one', 'two', 'three']
res = r.zrange("myzset", 2, 3)
print(res)
# >>> ['three']
res = r.zrange("myzset", -2, -1)
print(res)
# >>> ['two', 'three']
res = r.zadd("myzset", {"one": 1, "two":2, "three":3})
res = r.zrange("myzset", 0, 1, withscores=True)
print(res)
# >>> [('one', 1.0), ('two', 2.0)]
res = r.zadd("myzset", {"one": 1, "two":2, "three":3})
res = r.zrange("myzset", 2, 3, byscore=True, offset=1, num=1)
print(res)
# >>> ['three']
import { createClient } from 'redis';
const client = createClient();
client.on('error', err => console.log('Redis Client Error', err));
await client.connect().catch(console.error);
const val1 = await client.zAdd("myzset", [{ value: 'one', score: 1 }]);
console.log(val1);
// returns 1
const val2 = await client.zAdd("myzset", [{ value: 'uno', score: 1 }]);
console.log(val2);
// returns 1
const val3 = await client.zAdd("myzset", [{ value: 'two', score: 2 }, { value: 'three', score: 3 }]);
console.log(val3);
// returns 2
const val4 = await client.zRangeWithScores("myzset", 0, -1);
console.log(val4);
// returns [{value: 'one', score: 1}, {value: 'uno', score: 1}, {value: 'two', score: 2}, {value: 'three', score: 3} ]
const val5 = await client.zAdd("myzset", [
{ value: 'one', score: 1 },
{ value: 'two', score: 2 },
{ value: 'three', score: 3 }
]);
console.log(val5);
// returns 3
const val6 = await client.zRange('myzset', 0, -1);
console.log(val6);
// returns ['one', 'two', 'three']
const val7 = await client.zRange('myzset', 2, 3);
console.log(val7);
// returns ['three']
const val8 = await client.zRange('myzset', -2, -1);
console.log(val8);
// returns ['two', 'three']
const val9 = await client.zAdd("myzset", [
{ value: 'one', score: 1 },
{ value: 'two', score: 2 },
{ value: 'three', score: 3 }
]);
console.log(val9);
// returns 3
const val10 = await client.zRangeWithScores('myzset', 0, 1);
console.log(val10);
// returns [{value: 'one', score: 1}, {value: 'two', score: 2}]
const val11 = await client.zAdd("myzset", [
{ value: 'one', score: 1 },
{ value: 'two', score: 2 },
{ value: 'three', score: 3 }
]);
console.log(val11);
// returns 3
const val12 = await client.zRange('myzset', 2, 3, { BY: 'SCORE', LIMIT: { offset: 1, count: 1 } });
console.log(val12);
// >>> ['three']
await client.quit();
import java.util.HashMap;
import java.util.Map;
import java.util.List;
import redis.clients.jedis.UnifiedJedis;
import redis.clients.jedis.params.ZRangeParams;
import redis.clients.jedis.resps.Tuple;
public class CmdsSortedSetExample {
public void run() {
UnifiedJedis jedis = new UnifiedJedis("redis://localhost:6379");
// Tests for 'bzmpop' step.
// Tests for 'bzpopmax' step.
// Tests for 'bzpopmin' step.
Map<String, Double> zAddExampleParams = new HashMap<>();
zAddExampleParams.put("one", 1.0);
long zAddResult1 = jedis.zadd("myzset", zAddExampleParams);
System.out.println(zAddResult1); // >>> 1
zAddExampleParams.clear();
zAddExampleParams.put("uno", 1.0);
long zAddResult2 = jedis.zadd("myzset", zAddExampleParams);
System.out.println(zAddResult2); // >>> 1
zAddExampleParams.clear();
zAddExampleParams.put("two", 2.0);
zAddExampleParams.put("three", 3.0);
long zAddResult3 = jedis.zadd("myzset", zAddExampleParams);
System.out.println(zAddResult3); // >>> 2
List<Tuple> zAddResult4 = jedis.zrangeWithScores("myzset", new ZRangeParams(0, -1));
for (Tuple item: zAddResult4) {
System.out.println("Element: " + item.getElement() + ", Score: " + item.getScore());
}
// >>> Element: one, Score: 1.0
// >>> Element: uno, Score: 1.0
// >>> Element: two, Score: 2.0
// >>> Element: three, Score: 3.0
// Tests for 'zadd' step.
// Tests for 'zcard' step.
// Tests for 'zcount' step.
// Tests for 'zdiff' step.
// Tests for 'zdiffstore' step.
// Tests for 'zincrby' step.
// Tests for 'zinter' step.
// Tests for 'zintercard' step.
// Tests for 'zinterstore' step.
// Tests for 'zlexcount' step.
// Tests for 'zmpop' step.
// Tests for 'zmscore' step.
// Tests for 'zpopmax' step.
// Tests for 'zpopmin' step.
// Tests for 'zrandmember' step.
Map<String, Double> zRangeExampleParams1 = new HashMap<>();
zRangeExampleParams1.put("one", 1.0);
zRangeExampleParams1.put("two", 2.0);
zRangeExampleParams1.put("three", 3.0);
long zRangeResult1 = jedis.zadd("myzset", zRangeExampleParams1);
System.out.println(zRangeResult1); // >>> 3
List<String> zRangeResult2 = jedis.zrange("myzset", new ZRangeParams(0, -1));
System.out.println(String.join(", ", zRangeResult2)); // >>> one, two, three
List<String> zRangeResult3 = jedis.zrange("myzset", new ZRangeParams(2, 3));
System.out.println(String.join(", ", zRangeResult3)); // >> three
List<String> zRangeResult4 = jedis.zrange("myzset", new ZRangeParams(-2, -1));
System.out.println(String.join(", ", zRangeResult4)); // >> two, three
// Tests for 'zrange1' step.
Map<String, Double> zRangeExampleParams2 = new HashMap<>();
zRangeExampleParams2.put("one", 1.0);
zRangeExampleParams2.put("two", 2.0);
zRangeExampleParams2.put("three", 3.0);
long zRangeResult5 = jedis.zadd("myzset", zRangeExampleParams2);
System.out.println(zRangeResult5); // >>> 3
List<Tuple> zRangeResult6 = jedis.zrangeWithScores("myzset", new ZRangeParams(0, 1));
for (Tuple item: zRangeResult6) {
System.out.println("Element: " + item.getElement() + ", Score: " + item.getScore());
}
// >>> Element: one, Score: 1.0
// >>> Element: two, Score: 2.0
// Tests for 'zrange2' step.
Map<String, Double> zRangeExampleParams3 = new HashMap<>();
zRangeExampleParams3.put("one", 1.0);
zRangeExampleParams3.put("two", 2.0);
zRangeExampleParams3.put("three", 3.0);
long zRangeResult7 = jedis.zadd("myzset", zRangeExampleParams3);
System.out.println(zRangeResult7); // >>> 3
List<String> zRangeResult8 = jedis.zrangeByScore("myzset", "(1", "+inf", 1, 1);
System.out.println(String.join(", ", zRangeResult8)); // >>> three
// Tests for 'zrange3' step.
// Tests for 'zrangebylex' step.
// Tests for 'zrangebyscore' step.
// Tests for 'zrangestore' step.
// Tests for 'zrank' step.
// Tests for 'zrem' step.
// Tests for 'zremrangebylex' step.
// Tests for 'zremrangebyrank' step.
// Tests for 'zremrangebyscore' step.
// Tests for 'zrevrange' step.
// Tests for 'zrevrangebylex' step.
// Tests for 'zrevrangebyscore' step.
// Tests for 'zrevrank' step.
// Tests for 'zscan' step.
// Tests for 'zscore' step.
// Tests for 'zunion' step.
// Tests for 'zunionstore' step.
}
}
package example_commands_test
import (
"context"
"fmt"
"github.com/redis/go-redis/v9"
)
func ExampleClient_zadd_cmd() {
ctx := context.Background()
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // no password docs
DB: 0, // use default DB
})
zAddResult1, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "one", Score: 1},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zAddResult1) // >>> 1
zAddResult2, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "uno", Score: 1},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zAddResult2)
zAddResult3, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "two", Score: 2},
redis.Z{Member: "three", Score: 3},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zAddResult3) // >>> 2
zAddResult4, err := rdb.ZRangeWithScores(ctx, "myzset", 0, -1).Result()
if err != nil {
panic(err)
}
fmt.Println(zAddResult4) // >>> [{1 one} {1 uno} {2 two} {3 three}]
}
func ExampleClient_zrange1() {
ctx := context.Background()
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // no password docs
DB: 0, // use default DB
})
zrangeResult1, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "one", Score: 1},
redis.Z{Member: "two", Score: 2},
redis.Z{Member: "three", Score: 3},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zrangeResult1) // >>> 3
zrangeResult2, err := rdb.ZRange(ctx, "myzset", 0, -1).Result()
if err != nil {
panic(err)
}
fmt.Println(zrangeResult2) // >>> [one two three]
zrangeResult3, err := rdb.ZRange(ctx, "myzset", 2, 3).Result()
if err != nil {
panic(err)
}
fmt.Println(zrangeResult3) // >>> [three]
zrangeResult4, err := rdb.ZRange(ctx, "myzset", -2, -1).Result()
if err != nil {
panic(err)
}
fmt.Println(zrangeResult4) // >>> [two three]
}
func ExampleClient_zrange2() {
ctx := context.Background()
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // no password docs
DB: 0, // use default DB
})
zRangeResult5, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "one", Score: 1},
redis.Z{Member: "two", Score: 2},
redis.Z{Member: "three", Score: 3},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zRangeResult5) // >>> 3
zRangeResult6, err := rdb.ZRangeWithScores(ctx, "myzset", 0, 1).Result()
if err != nil {
panic(err)
}
fmt.Println(zRangeResult6) // >>> [{1 one} {2 two}]
}
func ExampleClient_zrange3() {
ctx := context.Background()
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // no password docs
DB: 0, // use default DB
})
zRangeResult7, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "one", Score: 1},
redis.Z{Member: "two", Score: 2},
redis.Z{Member: "three", Score: 3},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zRangeResult7) // >>> 3
zRangeResult8, err := rdb.ZRangeArgs(ctx,
redis.ZRangeArgs{
Key: "myzset",
ByScore: true,
Start: "(1",
Stop: "+inf",
Offset: 1,
Count: 1,
},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zRangeResult8) // >>> [three]
}
using NRedisStack.Tests;
using StackExchange.Redis;
public class CmdsSortedSet
{
public void run()
{
var muxer = ConnectionMultiplexer.Connect("localhost:6379");
var db = muxer.GetDatabase();
// Tests for 'bzmpop' step.
// Tests for 'bzpopmax' step.
// Tests for 'bzpopmin' step.
bool zAddResult1 = db.SortedSetAdd("myzset", "one", 1);
Console.WriteLine(zAddResult1); // >>> True
bool zAddResult2 = db.SortedSetAdd("myzset", "uno", 1);
Console.WriteLine(zAddResult2); // >>> True
long zAddResult3 = db.SortedSetAdd(
"myzset",
new SortedSetEntry[] {
new SortedSetEntry("two", 2),
new SortedSetEntry("three", 3)
}
);
Console.WriteLine(zAddResult3); // >>> 2
SortedSetEntry[] zAddResult4 = db.SortedSetRangeByRankWithScores("myzset", 0, -1);
Console.WriteLine($"{string.Join(", ", zAddResult4.Select(b => $"{b.Element}: {b.Score}"))}");
// >>> one: 1, uno: 1, two: 2, three: 3
// Tests for 'zadd' step.
// Tests for 'zcard' step.
// Tests for 'zcount' step.
// Tests for 'zdiff' step.
// Tests for 'zdiffstore' step.
// Tests for 'zincrby' step.
// Tests for 'zinter' step.
// Tests for 'zintercard' step.
// Tests for 'zinterstore' step.
// Tests for 'zlexcount' step.
// Tests for 'zmpop' step.
// Tests for 'zmscore' step.
// Tests for 'zpopmax' step.
// Tests for 'zpopmin' step.
// Tests for 'zrandmember' step.
long zRangeResult1 = db.SortedSetAdd(
"myzset",
new SortedSetEntry[] {
new SortedSetEntry("one", 1),
new SortedSetEntry("two", 2),
new SortedSetEntry("three", 3)
}
);
Console.WriteLine(zRangeResult1); // >>> 3
RedisValue[] zRangeResult2 = db.SortedSetRangeByRank("myzset", 0, -1);
Console.WriteLine(string.Join(", ", zRangeResult2));
// >>> one, two, three
RedisValue[] zRangeResult3 = db.SortedSetRangeByRank("myzset", 2, 3);
Console.WriteLine(string.Join(", ", zRangeResult3));
// >>> three
RedisValue[] zRangeResult4 = db.SortedSetRangeByRank("myzset", -2, -1);
Console.WriteLine(string.Join(", ", zRangeResult4));
// >>> two, three
// Tests for 'zrange1' step.
long zRangeResult5 = db.SortedSetAdd(
"myzset",
new SortedSetEntry[] {
new SortedSetEntry("one", 1),
new SortedSetEntry("two", 2),
new SortedSetEntry("three", 3)
}
);
SortedSetEntry[] zRangeResult6 = db.SortedSetRangeByRankWithScores("myzset", 0, 1);
Console.WriteLine($"{string.Join(", ", zRangeResult6.Select(b => $"{b.Element}: {b.Score}"))}");
// >>> one: 1, two: 2
// Tests for 'zrange2' step.
long zRangeResult7 = db.SortedSetAdd(
"myzset",
new SortedSetEntry[] {
new SortedSetEntry("one", 1),
new SortedSetEntry("two", 2),
new SortedSetEntry("three", 3)
}
);
RedisValue[] zRangeResult8 = db.SortedSetRangeByScore(
"myzset",
1,
double.PositiveInfinity,
Exclude.Start,
skip: 1, take: 1
);
Console.WriteLine(string.Join(", ", zRangeResult8));
// >>> three
// Tests for 'zrange3' step.
// Tests for 'zrangebylex' step.
// Tests for 'zrangebyscore' step.
// Tests for 'zrangestore' step.
// Tests for 'zrank' step.
// Tests for 'zrem' step.
// Tests for 'zremrangebylex' step.
// Tests for 'zremrangebyrank' step.
// Tests for 'zremrangebyscore' step.
// Tests for 'zrevrange' step.
// Tests for 'zrevrangebylex' step.
// Tests for 'zrevrangebyscore' step.
// Tests for 'zrevrank' step.
// Tests for 'zscan' step.
// Tests for 'zscore' step.
// Tests for 'zunion' step.
// Tests for 'zunionstore' step.
}
}
以下示例使用WITHSCORES展示了该命令如何始终返回一个数组，但这次填充了element_1、score_1、element_2、score_2、...、element_N、score_N。
> ZADD myzset 1 "one" 2 "two" 3 "three"
(integer) 3
> ZRANGE myzset 0 1 WITHSCORES
1) "one"
2) "1"
3) "two"
4) "2"Are you tired of using redis-cli? Try Redis Insight - the developer GUI for Redis.
import redis
r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
res = r.zadd("myzset", {"one": 1})
print(res)
# >>> 1
res = r.zadd("myzset", {"uno": 1})
print(res)
# >>> 1
res = r.zadd("myzset", {"two": 2, "three": 3})
print(res)
# >>> 2
res = r.zrange("myzset", 0, -1, withscores=True)
# >>> [('one', 1.0), ('uno', 1.0), ('two', 2.0), ('three', 3.0)]
res = r.zadd("myzset", {"one": 1, "two":2, "three":3})
print(res)
# >>> 3
res = r.zrange("myzset", 0, -1)
print(res)
# >>> ['one', 'two', 'three']
res = r.zrange("myzset", 2, 3)
print(res)
# >>> ['three']
res = r.zrange("myzset", -2, -1)
print(res)
# >>> ['two', 'three']
res = r.zadd("myzset", {"one": 1, "two":2, "three":3})
res = r.zrange("myzset", 0, 1, withscores=True)
print(res)
# >>> [('one', 1.0), ('two', 2.0)]
res = r.zadd("myzset", {"one": 1, "two":2, "three":3})
res = r.zrange("myzset", 2, 3, byscore=True, offset=1, num=1)
print(res)
# >>> ['three']
import { createClient } from 'redis';
const client = createClient();
client.on('error', err => console.log('Redis Client Error', err));
await client.connect().catch(console.error);
const val1 = await client.zAdd("myzset", [{ value: 'one', score: 1 }]);
console.log(val1);
// returns 1
const val2 = await client.zAdd("myzset", [{ value: 'uno', score: 1 }]);
console.log(val2);
// returns 1
const val3 = await client.zAdd("myzset", [{ value: 'two', score: 2 }, { value: 'three', score: 3 }]);
console.log(val3);
// returns 2
const val4 = await client.zRangeWithScores("myzset", 0, -1);
console.log(val4);
// returns [{value: 'one', score: 1}, {value: 'uno', score: 1}, {value: 'two', score: 2}, {value: 'three', score: 3} ]
const val5 = await client.zAdd("myzset", [
{ value: 'one', score: 1 },
{ value: 'two', score: 2 },
{ value: 'three', score: 3 }
]);
console.log(val5);
// returns 3
const val6 = await client.zRange('myzset', 0, -1);
console.log(val6);
// returns ['one', 'two', 'three']
const val7 = await client.zRange('myzset', 2, 3);
console.log(val7);
// returns ['three']
const val8 = await client.zRange('myzset', -2, -1);
console.log(val8);
// returns ['two', 'three']
const val9 = await client.zAdd("myzset", [
{ value: 'one', score: 1 },
{ value: 'two', score: 2 },
{ value: 'three', score: 3 }
]);
console.log(val9);
// returns 3
const val10 = await client.zRangeWithScores('myzset', 0, 1);
console.log(val10);
// returns [{value: 'one', score: 1}, {value: 'two', score: 2}]
const val11 = await client.zAdd("myzset", [
{ value: 'one', score: 1 },
{ value: 'two', score: 2 },
{ value: 'three', score: 3 }
]);
console.log(val11);
// returns 3
const val12 = await client.zRange('myzset', 2, 3, { BY: 'SCORE', LIMIT: { offset: 1, count: 1 } });
console.log(val12);
// >>> ['three']
await client.quit();
import java.util.HashMap;
import java.util.Map;
import java.util.List;
import redis.clients.jedis.UnifiedJedis;
import redis.clients.jedis.params.ZRangeParams;
import redis.clients.jedis.resps.Tuple;
public class CmdsSortedSetExample {
public void run() {
UnifiedJedis jedis = new UnifiedJedis("redis://localhost:6379");
// Tests for 'bzmpop' step.
// Tests for 'bzpopmax' step.
// Tests for 'bzpopmin' step.
Map<String, Double> zAddExampleParams = new HashMap<>();
zAddExampleParams.put("one", 1.0);
long zAddResult1 = jedis.zadd("myzset", zAddExampleParams);
System.out.println(zAddResult1); // >>> 1
zAddExampleParams.clear();
zAddExampleParams.put("uno", 1.0);
long zAddResult2 = jedis.zadd("myzset", zAddExampleParams);
System.out.println(zAddResult2); // >>> 1
zAddExampleParams.clear();
zAddExampleParams.put("two", 2.0);
zAddExampleParams.put("three", 3.0);
long zAddResult3 = jedis.zadd("myzset", zAddExampleParams);
System.out.println(zAddResult3); // >>> 2
List<Tuple> zAddResult4 = jedis.zrangeWithScores("myzset", new ZRangeParams(0, -1));
for (Tuple item: zAddResult4) {
System.out.println("Element: " + item.getElement() + ", Score: " + item.getScore());
}
// >>> Element: one, Score: 1.0
// >>> Element: uno, Score: 1.0
// >>> Element: two, Score: 2.0
// >>> Element: three, Score: 3.0
// Tests for 'zadd' step.
// Tests for 'zcard' step.
// Tests for 'zcount' step.
// Tests for 'zdiff' step.
// Tests for 'zdiffstore' step.
// Tests for 'zincrby' step.
// Tests for 'zinter' step.
// Tests for 'zintercard' step.
// Tests for 'zinterstore' step.
// Tests for 'zlexcount' step.
// Tests for 'zmpop' step.
// Tests for 'zmscore' step.
// Tests for 'zpopmax' step.
// Tests for 'zpopmin' step.
// Tests for 'zrandmember' step.
Map<String, Double> zRangeExampleParams1 = new HashMap<>();
zRangeExampleParams1.put("one", 1.0);
zRangeExampleParams1.put("two", 2.0);
zRangeExampleParams1.put("three", 3.0);
long zRangeResult1 = jedis.zadd("myzset", zRangeExampleParams1);
System.out.println(zRangeResult1); // >>> 3
List<String> zRangeResult2 = jedis.zrange("myzset", new ZRangeParams(0, -1));
System.out.println(String.join(", ", zRangeResult2)); // >>> one, two, three
List<String> zRangeResult3 = jedis.zrange("myzset", new ZRangeParams(2, 3));
System.out.println(String.join(", ", zRangeResult3)); // >> three
List<String> zRangeResult4 = jedis.zrange("myzset", new ZRangeParams(-2, -1));
System.out.println(String.join(", ", zRangeResult4)); // >> two, three
// Tests for 'zrange1' step.
Map<String, Double> zRangeExampleParams2 = new HashMap<>();
zRangeExampleParams2.put("one", 1.0);
zRangeExampleParams2.put("two", 2.0);
zRangeExampleParams2.put("three", 3.0);
long zRangeResult5 = jedis.zadd("myzset", zRangeExampleParams2);
System.out.println(zRangeResult5); // >>> 3
List<Tuple> zRangeResult6 = jedis.zrangeWithScores("myzset", new ZRangeParams(0, 1));
for (Tuple item: zRangeResult6) {
System.out.println("Element: " + item.getElement() + ", Score: " + item.getScore());
}
// >>> Element: one, Score: 1.0
// >>> Element: two, Score: 2.0
// Tests for 'zrange2' step.
Map<String, Double> zRangeExampleParams3 = new HashMap<>();
zRangeExampleParams3.put("one", 1.0);
zRangeExampleParams3.put("two", 2.0);
zRangeExampleParams3.put("three", 3.0);
long zRangeResult7 = jedis.zadd("myzset", zRangeExampleParams3);
System.out.println(zRangeResult7); // >>> 3
List<String> zRangeResult8 = jedis.zrangeByScore("myzset", "(1", "+inf", 1, 1);
System.out.println(String.join(", ", zRangeResult8)); // >>> three
// Tests for 'zrange3' step.
// Tests for 'zrangebylex' step.
// Tests for 'zrangebyscore' step.
// Tests for 'zrangestore' step.
// Tests for 'zrank' step.
// Tests for 'zrem' step.
// Tests for 'zremrangebylex' step.
// Tests for 'zremrangebyrank' step.
// Tests for 'zremrangebyscore' step.
// Tests for 'zrevrange' step.
// Tests for 'zrevrangebylex' step.
// Tests for 'zrevrangebyscore' step.
// Tests for 'zrevrank' step.
// Tests for 'zscan' step.
// Tests for 'zscore' step.
// Tests for 'zunion' step.
// Tests for 'zunionstore' step.
}
}
package example_commands_test
import (
"context"
"fmt"
"github.com/redis/go-redis/v9"
)
func ExampleClient_zadd_cmd() {
ctx := context.Background()
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // no password docs
DB: 0, // use default DB
})
zAddResult1, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "one", Score: 1},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zAddResult1) // >>> 1
zAddResult2, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "uno", Score: 1},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zAddResult2)
zAddResult3, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "two", Score: 2},
redis.Z{Member: "three", Score: 3},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zAddResult3) // >>> 2
zAddResult4, err := rdb.ZRangeWithScores(ctx, "myzset", 0, -1).Result()
if err != nil {
panic(err)
}
fmt.Println(zAddResult4) // >>> [{1 one} {1 uno} {2 two} {3 three}]
}
func ExampleClient_zrange1() {
ctx := context.Background()
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // no password docs
DB: 0, // use default DB
})
zrangeResult1, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "one", Score: 1},
redis.Z{Member: "two", Score: 2},
redis.Z{Member: "three", Score: 3},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zrangeResult1) // >>> 3
zrangeResult2, err := rdb.ZRange(ctx, "myzset", 0, -1).Result()
if err != nil {
panic(err)
}
fmt.Println(zrangeResult2) // >>> [one two three]
zrangeResult3, err := rdb.ZRange(ctx, "myzset", 2, 3).Result()
if err != nil {
panic(err)
}
fmt.Println(zrangeResult3) // >>> [three]
zrangeResult4, err := rdb.ZRange(ctx, "myzset", -2, -1).Result()
if err != nil {
panic(err)
}
fmt.Println(zrangeResult4) // >>> [two three]
}
func ExampleClient_zrange2() {
ctx := context.Background()
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // no password docs
DB: 0, // use default DB
})
zRangeResult5, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "one", Score: 1},
redis.Z{Member: "two", Score: 2},
redis.Z{Member: "three", Score: 3},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zRangeResult5) // >>> 3
zRangeResult6, err := rdb.ZRangeWithScores(ctx, "myzset", 0, 1).Result()
if err != nil {
panic(err)
}
fmt.Println(zRangeResult6) // >>> [{1 one} {2 two}]
}
func ExampleClient_zrange3() {
ctx := context.Background()
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // no password docs
DB: 0, // use default DB
})
zRangeResult7, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "one", Score: 1},
redis.Z{Member: "two", Score: 2},
redis.Z{Member: "three", Score: 3},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zRangeResult7) // >>> 3
zRangeResult8, err := rdb.ZRangeArgs(ctx,
redis.ZRangeArgs{
Key: "myzset",
ByScore: true,
Start: "(1",
Stop: "+inf",
Offset: 1,
Count: 1,
},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zRangeResult8) // >>> [three]
}
using NRedisStack.Tests;
using StackExchange.Redis;
public class CmdsSortedSet
{
public void run()
{
var muxer = ConnectionMultiplexer.Connect("localhost:6379");
var db = muxer.GetDatabase();
// Tests for 'bzmpop' step.
// Tests for 'bzpopmax' step.
// Tests for 'bzpopmin' step.
bool zAddResult1 = db.SortedSetAdd("myzset", "one", 1);
Console.WriteLine(zAddResult1); // >>> True
bool zAddResult2 = db.SortedSetAdd("myzset", "uno", 1);
Console.WriteLine(zAddResult2); // >>> True
long zAddResult3 = db.SortedSetAdd(
"myzset",
new SortedSetEntry[] {
new SortedSetEntry("two", 2),
new SortedSetEntry("three", 3)
}
);
Console.WriteLine(zAddResult3); // >>> 2
SortedSetEntry[] zAddResult4 = db.SortedSetRangeByRankWithScores("myzset", 0, -1);
Console.WriteLine($"{string.Join(", ", zAddResult4.Select(b => $"{b.Element}: {b.Score}"))}");
// >>> one: 1, uno: 1, two: 2, three: 3
// Tests for 'zadd' step.
// Tests for 'zcard' step.
// Tests for 'zcount' step.
// Tests for 'zdiff' step.
// Tests for 'zdiffstore' step.
// Tests for 'zincrby' step.
// Tests for 'zinter' step.
// Tests for 'zintercard' step.
// Tests for 'zinterstore' step.
// Tests for 'zlexcount' step.
// Tests for 'zmpop' step.
// Tests for 'zmscore' step.
// Tests for 'zpopmax' step.
// Tests for 'zpopmin' step.
// Tests for 'zrandmember' step.
long zRangeResult1 = db.SortedSetAdd(
"myzset",
new SortedSetEntry[] {
new SortedSetEntry("one", 1),
new SortedSetEntry("two", 2),
new SortedSetEntry("three", 3)
}
);
Console.WriteLine(zRangeResult1); // >>> 3
RedisValue[] zRangeResult2 = db.SortedSetRangeByRank("myzset", 0, -1);
Console.WriteLine(string.Join(", ", zRangeResult2));
// >>> one, two, three
RedisValue[] zRangeResult3 = db.SortedSetRangeByRank("myzset", 2, 3);
Console.WriteLine(string.Join(", ", zRangeResult3));
// >>> three
RedisValue[] zRangeResult4 = db.SortedSetRangeByRank("myzset", -2, -1);
Console.WriteLine(string.Join(", ", zRangeResult4));
// >>> two, three
// Tests for 'zrange1' step.
long zRangeResult5 = db.SortedSetAdd(
"myzset",
new SortedSetEntry[] {
new SortedSetEntry("one", 1),
new SortedSetEntry("two", 2),
new SortedSetEntry("three", 3)
}
);
SortedSetEntry[] zRangeResult6 = db.SortedSetRangeByRankWithScores("myzset", 0, 1);
Console.WriteLine($"{string.Join(", ", zRangeResult6.Select(b => $"{b.Element}: {b.Score}"))}");
// >>> one: 1, two: 2
// Tests for 'zrange2' step.
long zRangeResult7 = db.SortedSetAdd(
"myzset",
new SortedSetEntry[] {
new SortedSetEntry("one", 1),
new SortedSetEntry("two", 2),
new SortedSetEntry("three", 3)
}
);
RedisValue[] zRangeResult8 = db.SortedSetRangeByScore(
"myzset",
1,
double.PositiveInfinity,
Exclude.Start,
skip: 1, take: 1
);
Console.WriteLine(string.Join(", ", zRangeResult8));
// >>> three
// Tests for 'zrange3' step.
// Tests for 'zrangebylex' step.
// Tests for 'zrangebyscore' step.
// Tests for 'zrangestore' step.
// Tests for 'zrank' step.
// Tests for 'zrem' step.
// Tests for 'zremrangebylex' step.
// Tests for 'zremrangebyrank' step.
// Tests for 'zremrangebyscore' step.
// Tests for 'zrevrange' step.
// Tests for 'zrevrangebylex' step.
// Tests for 'zrevrangebyscore' step.
// Tests for 'zrevrank' step.
// Tests for 'zscan' step.
// Tests for 'zscore' step.
// Tests for 'zunion' step.
// Tests for 'zunionstore' step.
}
}
此示例展示了如何按分数查询排序集，排除值 1 并直到无穷大，仅返回结果的第二个元素：
> ZADD myzset 1 "one" 2 "two" 3 "three"
(integer) 3
> ZRANGE myzset (1 +inf BYSCORE LIMIT 1 1
1) "three"Are you tired of using redis-cli? Try Redis Insight - the developer GUI for Redis.
import redis
r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
res = r.zadd("myzset", {"one": 1})
print(res)
# >>> 1
res = r.zadd("myzset", {"uno": 1})
print(res)
# >>> 1
res = r.zadd("myzset", {"two": 2, "three": 3})
print(res)
# >>> 2
res = r.zrange("myzset", 0, -1, withscores=True)
# >>> [('one', 1.0), ('uno', 1.0), ('two', 2.0), ('three', 3.0)]
res = r.zadd("myzset", {"one": 1, "two":2, "three":3})
print(res)
# >>> 3
res = r.zrange("myzset", 0, -1)
print(res)
# >>> ['one', 'two', 'three']
res = r.zrange("myzset", 2, 3)
print(res)
# >>> ['three']
res = r.zrange("myzset", -2, -1)
print(res)
# >>> ['two', 'three']
res = r.zadd("myzset", {"one": 1, "two":2, "three":3})
res = r.zrange("myzset", 0, 1, withscores=True)
print(res)
# >>> [('one', 1.0), ('two', 2.0)]
res = r.zadd("myzset", {"one": 1, "two":2, "three":3})
res = r.zrange("myzset", 2, 3, byscore=True, offset=1, num=1)
print(res)
# >>> ['three']
import { createClient } from 'redis';
const client = createClient();
client.on('error', err => console.log('Redis Client Error', err));
await client.connect().catch(console.error);
const val1 = await client.zAdd("myzset", [{ value: 'one', score: 1 }]);
console.log(val1);
// returns 1
const val2 = await client.zAdd("myzset", [{ value: 'uno', score: 1 }]);
console.log(val2);
// returns 1
const val3 = await client.zAdd("myzset", [{ value: 'two', score: 2 }, { value: 'three', score: 3 }]);
console.log(val3);
// returns 2
const val4 = await client.zRangeWithScores("myzset", 0, -1);
console.log(val4);
// returns [{value: 'one', score: 1}, {value: 'uno', score: 1}, {value: 'two', score: 2}, {value: 'three', score: 3} ]
const val5 = await client.zAdd("myzset", [
{ value: 'one', score: 1 },
{ value: 'two', score: 2 },
{ value: 'three', score: 3 }
]);
console.log(val5);
// returns 3
const val6 = await client.zRange('myzset', 0, -1);
console.log(val6);
// returns ['one', 'two', 'three']
const val7 = await client.zRange('myzset', 2, 3);
console.log(val7);
// returns ['three']
const val8 = await client.zRange('myzset', -2, -1);
console.log(val8);
// returns ['two', 'three']
const val9 = await client.zAdd("myzset", [
{ value: 'one', score: 1 },
{ value: 'two', score: 2 },
{ value: 'three', score: 3 }
]);
console.log(val9);
// returns 3
const val10 = await client.zRangeWithScores('myzset', 0, 1);
console.log(val10);
// returns [{value: 'one', score: 1}, {value: 'two', score: 2}]
const val11 = await client.zAdd("myzset", [
{ value: 'one', score: 1 },
{ value: 'two', score: 2 },
{ value: 'three', score: 3 }
]);
console.log(val11);
// returns 3
const val12 = await client.zRange('myzset', 2, 3, { BY: 'SCORE', LIMIT: { offset: 1, count: 1 } });
console.log(val12);
// >>> ['three']
await client.quit();
import java.util.HashMap;
import java.util.Map;
import java.util.List;
import redis.clients.jedis.UnifiedJedis;
import redis.clients.jedis.params.ZRangeParams;
import redis.clients.jedis.resps.Tuple;
public class CmdsSortedSetExample {
public void run() {
UnifiedJedis jedis = new UnifiedJedis("redis://localhost:6379");
// Tests for 'bzmpop' step.
// Tests for 'bzpopmax' step.
// Tests for 'bzpopmin' step.
Map<String, Double> zAddExampleParams = new HashMap<>();
zAddExampleParams.put("one", 1.0);
long zAddResult1 = jedis.zadd("myzset", zAddExampleParams);
System.out.println(zAddResult1); // >>> 1
zAddExampleParams.clear();
zAddExampleParams.put("uno", 1.0);
long zAddResult2 = jedis.zadd("myzset", zAddExampleParams);
System.out.println(zAddResult2); // >>> 1
zAddExampleParams.clear();
zAddExampleParams.put("two", 2.0);
zAddExampleParams.put("three", 3.0);
long zAddResult3 = jedis.zadd("myzset", zAddExampleParams);
System.out.println(zAddResult3); // >>> 2
List<Tuple> zAddResult4 = jedis.zrangeWithScores("myzset", new ZRangeParams(0, -1));
for (Tuple item: zAddResult4) {
System.out.println("Element: " + item.getElement() + ", Score: " + item.getScore());
}
// >>> Element: one, Score: 1.0
// >>> Element: uno, Score: 1.0
// >>> Element: two, Score: 2.0
// >>> Element: three, Score: 3.0
// Tests for 'zadd' step.
// Tests for 'zcard' step.
// Tests for 'zcount' step.
// Tests for 'zdiff' step.
// Tests for 'zdiffstore' step.
// Tests for 'zincrby' step.
// Tests for 'zinter' step.
// Tests for 'zintercard' step.
// Tests for 'zinterstore' step.
// Tests for 'zlexcount' step.
// Tests for 'zmpop' step.
// Tests for 'zmscore' step.
// Tests for 'zpopmax' step.
// Tests for 'zpopmin' step.
// Tests for 'zrandmember' step.
Map<String, Double> zRangeExampleParams1 = new HashMap<>();
zRangeExampleParams1.put("one", 1.0);
zRangeExampleParams1.put("two", 2.0);
zRangeExampleParams1.put("three", 3.0);
long zRangeResult1 = jedis.zadd("myzset", zRangeExampleParams1);
System.out.println(zRangeResult1); // >>> 3
List<String> zRangeResult2 = jedis.zrange("myzset", new ZRangeParams(0, -1));
System.out.println(String.join(", ", zRangeResult2)); // >>> one, two, three
List<String> zRangeResult3 = jedis.zrange("myzset", new ZRangeParams(2, 3));
System.out.println(String.join(", ", zRangeResult3)); // >> three
List<String> zRangeResult4 = jedis.zrange("myzset", new ZRangeParams(-2, -1));
System.out.println(String.join(", ", zRangeResult4)); // >> two, three
// Tests for 'zrange1' step.
Map<String, Double> zRangeExampleParams2 = new HashMap<>();
zRangeExampleParams2.put("one", 1.0);
zRangeExampleParams2.put("two", 2.0);
zRangeExampleParams2.put("three", 3.0);
long zRangeResult5 = jedis.zadd("myzset", zRangeExampleParams2);
System.out.println(zRangeResult5); // >>> 3
List<Tuple> zRangeResult6 = jedis.zrangeWithScores("myzset", new ZRangeParams(0, 1));
for (Tuple item: zRangeResult6) {
System.out.println("Element: " + item.getElement() + ", Score: " + item.getScore());
}
// >>> Element: one, Score: 1.0
// >>> Element: two, Score: 2.0
// Tests for 'zrange2' step.
Map<String, Double> zRangeExampleParams3 = new HashMap<>();
zRangeExampleParams3.put("one", 1.0);
zRangeExampleParams3.put("two", 2.0);
zRangeExampleParams3.put("three", 3.0);
long zRangeResult7 = jedis.zadd("myzset", zRangeExampleParams3);
System.out.println(zRangeResult7); // >>> 3
List<String> zRangeResult8 = jedis.zrangeByScore("myzset", "(1", "+inf", 1, 1);
System.out.println(String.join(", ", zRangeResult8)); // >>> three
// Tests for 'zrange3' step.
// Tests for 'zrangebylex' step.
// Tests for 'zrangebyscore' step.
// Tests for 'zrangestore' step.
// Tests for 'zrank' step.
// Tests for 'zrem' step.
// Tests for 'zremrangebylex' step.
// Tests for 'zremrangebyrank' step.
// Tests for 'zremrangebyscore' step.
// Tests for 'zrevrange' step.
// Tests for 'zrevrangebylex' step.
// Tests for 'zrevrangebyscore' step.
// Tests for 'zrevrank' step.
// Tests for 'zscan' step.
// Tests for 'zscore' step.
// Tests for 'zunion' step.
// Tests for 'zunionstore' step.
}
}
package example_commands_test
import (
"context"
"fmt"
"github.com/redis/go-redis/v9"
)
func ExampleClient_zadd_cmd() {
ctx := context.Background()
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // no password docs
DB: 0, // use default DB
})
zAddResult1, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "one", Score: 1},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zAddResult1) // >>> 1
zAddResult2, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "uno", Score: 1},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zAddResult2)
zAddResult3, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "two", Score: 2},
redis.Z{Member: "three", Score: 3},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zAddResult3) // >>> 2
zAddResult4, err := rdb.ZRangeWithScores(ctx, "myzset", 0, -1).Result()
if err != nil {
panic(err)
}
fmt.Println(zAddResult4) // >>> [{1 one} {1 uno} {2 two} {3 three}]
}
func ExampleClient_zrange1() {
ctx := context.Background()
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // no password docs
DB: 0, // use default DB
})
zrangeResult1, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "one", Score: 1},
redis.Z{Member: "two", Score: 2},
redis.Z{Member: "three", Score: 3},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zrangeResult1) // >>> 3
zrangeResult2, err := rdb.ZRange(ctx, "myzset", 0, -1).Result()
if err != nil {
panic(err)
}
fmt.Println(zrangeResult2) // >>> [one two three]
zrangeResult3, err := rdb.ZRange(ctx, "myzset", 2, 3).Result()
if err != nil {
panic(err)
}
fmt.Println(zrangeResult3) // >>> [three]
zrangeResult4, err := rdb.ZRange(ctx, "myzset", -2, -1).Result()
if err != nil {
panic(err)
}
fmt.Println(zrangeResult4) // >>> [two three]
}
func ExampleClient_zrange2() {
ctx := context.Background()
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // no password docs
DB: 0, // use default DB
})
zRangeResult5, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "one", Score: 1},
redis.Z{Member: "two", Score: 2},
redis.Z{Member: "three", Score: 3},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zRangeResult5) // >>> 3
zRangeResult6, err := rdb.ZRangeWithScores(ctx, "myzset", 0, 1).Result()
if err != nil {
panic(err)
}
fmt.Println(zRangeResult6) // >>> [{1 one} {2 two}]
}
func ExampleClient_zrange3() {
ctx := context.Background()
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
Password: "", // no password docs
DB: 0, // use default DB
})
zRangeResult7, err := rdb.ZAdd(ctx, "myzset",
redis.Z{Member: "one", Score: 1},
redis.Z{Member: "two", Score: 2},
redis.Z{Member: "three", Score: 3},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zRangeResult7) // >>> 3
zRangeResult8, err := rdb.ZRangeArgs(ctx,
redis.ZRangeArgs{
Key: "myzset",
ByScore: true,
Start: "(1",
Stop: "+inf",
Offset: 1,
Count: 1,
},
).Result()
if err != nil {
panic(err)
}
fmt.Println(zRangeResult8) // >>> [three]
}
using NRedisStack.Tests;
using StackExchange.Redis;
public class CmdsSortedSet
{
public void run()
{
var muxer = ConnectionMultiplexer.Connect("localhost:6379");
var db = muxer.GetDatabase();
// Tests for 'bzmpop' step.
// Tests for 'bzpopmax' step.
// Tests for 'bzpopmin' step.
bool zAddResult1 = db.SortedSetAdd("myzset", "one", 1);
Console.WriteLine(zAddResult1); // >>> True
bool zAddResult2 = db.SortedSetAdd("myzset", "uno", 1);
Console.WriteLine(zAddResult2); // >>> True
long zAddResult3 = db.SortedSetAdd(
"myzset",
new SortedSetEntry[] {
new SortedSetEntry("two", 2),
new SortedSetEntry("three", 3)
}
);
Console.WriteLine(zAddResult3); // >>> 2
SortedSetEntry[] zAddResult4 = db.SortedSetRangeByRankWithScores("myzset", 0, -1);
Console.WriteLine($"{string.Join(", ", zAddResult4.Select(b => $"{b.Element}: {b.Score}"))}");
// >>> one: 1, uno: 1, two: 2, three: 3
// Tests for 'zadd' step.
// Tests for 'zcard' step.
// Tests for 'zcount' step.
// Tests for 'zdiff' step.
// Tests for 'zdiffstore' step.
// Tests for 'zincrby' step.
// Tests for 'zinter' step.
// Tests for 'zintercard' step.
// Tests for 'zinterstore' step.
// Tests for 'zlexcount' step.
// Tests for 'zmpop' step.
// Tests for 'zmscore' step.
// Tests for 'zpopmax' step.
// Tests for 'zpopmin' step.
// Tests for 'zrandmember' step.
long zRangeResult1 = db.SortedSetAdd(
"myzset",
new SortedSetEntry[] {
new SortedSetEntry("one", 1),
new SortedSetEntry("two", 2),
new SortedSetEntry("three", 3)
}
);
Console.WriteLine(zRangeResult1); // >>> 3
RedisValue[] zRangeResult2 = db.SortedSetRangeByRank("myzset", 0, -1);
Console.WriteLine(string.Join(", ", zRangeResult2));
// >>> one, two, three
RedisValue[] zRangeResult3 = db.SortedSetRangeByRank("myzset", 2, 3);
Console.WriteLine(string.Join(", ", zRangeResult3));
// >>> three
RedisValue[] zRangeResult4 = db.SortedSetRangeByRank("myzset", -2, -1);
Console.WriteLine(string.Join(", ", zRangeResult4));
// >>> two, three
// Tests for 'zrange1' step.
long zRangeResult5 = db.SortedSetAdd(
"myzset",
new SortedSetEntry[] {
new SortedSetEntry("one", 1),
new SortedSetEntry("two", 2),
new SortedSetEntry("three", 3)
}
);
SortedSetEntry[] zRangeResult6 = db.SortedSetRangeByRankWithScores("myzset", 0, 1);
Console.WriteLine($"{string.Join(", ", zRangeResult6.Select(b => $"{b.Element}: {b.Score}"))}");
// >>> one: 1, two: 2
// Tests for 'zrange2' step.
long zRangeResult7 = db.SortedSetAdd(
"myzset",
new SortedSetEntry[] {
new SortedSetEntry("one", 1),
new SortedSetEntry("two", 2),
new SortedSetEntry("three", 3)
}
);
RedisValue[] zRangeResult8 = db.SortedSetRangeByScore(
"myzset",
1,
double.PositiveInfinity,
Exclude.Start,
skip: 1, take: 1
);
Console.WriteLine(string.Join(", ", zRangeResult8));
// >>> three
// Tests for 'zrange3' step.
// Tests for 'zrangebylex' step.
// Tests for 'zrangebyscore' step.
// Tests for 'zrangestore' step.
// Tests for 'zrank' step.
// Tests for 'zrem' step.
// Tests for 'zremrangebylex' step.
// Tests for 'zremrangebyrank' step.
// Tests for 'zremrangebyscore' step.
// Tests for 'zrevrange' step.
// Tests for 'zrevrangebylex' step.
// Tests for 'zrevrangebyscore' step.
// Tests for 'zrevrank' step.
// Tests for 'zscan' step.
// Tests for 'zscore' step.
// Tests for 'zunion' step.
// Tests for 'zunionstore' step.
}
}
在交互式控制台中尝试这些命令：
RESP2/RESP3 回复
Array reply: a list of members in the specified range with, optionally, their scores when the WITHSCORES option is given.历史
- 从 Redis 6.2.0 版本开始：添加了
REV、BYSCORE、BYLEX和LIMIT选项。