ZRANGE
语法
ZRANGE key start stop [BYSCORE | BYLEX] [REV] [LIMIT offset count] [WITHSCORES]
- 可用版本
- Redis 开源版 1.2.0
- 时间复杂度
- O(log(N)+M)，其中 N 是有序集合中的元素数量，M 是返回的元素数量。
- ACL 类别
-
@read,@sortedset,@slow,
返回存储在 <key> 处的有序集合中指定范围的元素。
ZRANGE 可以执行不同类型的范围查询：按索引（排名）、按分数或按字典顺序。
从 Redis 6.2.0 版本开始，此命令可以替代以下命令：ZREVRANGE、ZRANGEBYSCORE、ZREVRANGEBYSCORE、ZRANGEBYLEX 和 ZREVRANGEBYLEX。
常见行为和选项
元素的顺序从最低分数到最高分数排列。分数相同的元素按字典顺序排列。
可选的 REV 参数反转排序，因此元素按从最高分数到最低分数的顺序排列，分数相同时按反向字典顺序解决。
可选的 LIMIT 参数可用于获取匹配元素的子范围（类似于 SQL 中的 SELECT LIMIT offset, count）。负数 <count> 返回从 <offset> 开始的所有元素。请注意，如果 <offset> 很大，则需要遍历 <offset> 个元素才能到达要返回的元素，这可能会增加到 O(N) 的时间复杂度。
可选的 WITHSCORES 参数在命令回复中补充返回元素的分数。返回的列表包含 value1,score1,...,valueN,scoreN，而不是 value1,...,valueN。客户端库可以自由返回更合适的数据类型（建议：包含 (value, score) 数组/元组的数组）。
索引范围
默认情况下，该命令执行索引范围查询。<start> 和 <stop> 参数表示从零开始的索引，其中 0 是第一个元素，1 是下一个元素，依此类推。这些参数指定一个**包含范围**，例如，ZRANGE myzset 0 1 将返回有序集合中的第一个和第二个元素。
索引也可以是负数，表示从有序集合末尾的偏移量，其中 -1 是有序集合的最后一个元素，-2 是倒数第二个元素，依此类推。
超出范围的索引不会产生错误。
如果 <start> 大于有序集合的结束索引或 <stop>，则返回一个空列表。
如果 <stop> 大于有序集合的结束索引，Redis 将使用有序集合的最后一个元素。
分数范围
当提供 BYSCORE 选项时，该命令的行为类似于 ZRANGEBYSCORE，并返回有序集合中分数等于或介于 <start> 和 <stop> 之间的元素的范围。
<start> 和 <stop> 可以是 -inf 和 +inf，分别表示负无穷和正无穷。这意味着您无需知道有序集合中的最高或最低分数即可获取从某个分数开始或到某个分数为止的所有元素。
默认情况下，由 <start> 和 <stop> 指定的分数区间是闭合的（包含）。可以通过在分数前加上字符 ( 来指定开放区间（不包含）。
例如
ZRANGE zset (1 5 BYSCORE
将返回所有 1 < score <= 5 的元素，而
ZRANGE zset (5 (10 BYSCORE
将返回所有 5 < score < 10 的元素（不包括 5 和 10）。
反向范围
使用 REV 选项反转有序集合，索引 0 为分数最高的元素。
默认情况下，<start> 必须小于或等于 <stop> 才能返回任何结果。但是，如果选择了 BYSCORE 或 BYLEX 选项，则 <start> 是要考虑的最高分数，而 <stop> 是要考虑的最低分数，因此 <start> 必须大于或等于 <stop> 才能返回任何结果。
例如
ZRANGE zset 5 10 REV
将返回反向索引中索引 5 到 10 之间的元素。
ZRANGE zset 10 5 REV BYSCORE
将返回分数小于 10 且大于 5 的所有元素。
字典序范围
当使用 BYLEX 选项时，该命令的行为类似于 ZRANGEBYLEX，并返回有序集合中介于 <start> 和 <stop> 字典序闭合范围之间的元素范围。
请注意，字典序排序依赖于所有元素具有相同的分数。当元素具有不同分数时，回复是未指定的。
有效的 <start> 和 <stop> 必须以 ( 或 [ 开头，分别指定范围区间是排他性还是包含性。
<start> 和 <stop> 的特殊值 + 或 - 分别表示正无穷和负无穷字符串，因此例如命令 ZRANGE myzset - + BYLEX 保证返回有序集合中的所有元素，前提是所有元素都具有相同的分数。
REV 选项反转 <start> 和 <stop> 元素的顺序，其中 <start> 在字典序上必须大于 <stop> 才能产生非空结果。
字符串的字典序比较
字符串被视为字节的二进制数组进行比较。由于 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"厌倦了使用 redis-cli？试试 Redis Insight - 面向开发者的 Redis GUI 工具。
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;
import static org.junit.jupiter.api.Assertions.assertEquals;
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.
jedis.close();
}
}
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 的示例展示了该命令如何始终返回一个数组，但这次填充了 元素_1、分数_1、元素_2、分数_2、...、元素_N、分数_N。
> ZADD myzset 1 "one" 2 "two" 3 "three"
(integer) 3
> ZRANGE myzset 0 1 WITHSCORES
1) "one"
2) "1"
3) "two"
4) "2"厌倦了使用 redis-cli？试试 Redis Insight - 面向开发者的 Redis GUI 工具。
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;
import static org.junit.jupiter.api.Assertions.assertEquals;
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.
jedis.close();
}
}
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"厌倦了使用 redis-cli？试试 Redis Insight - 面向开发者的 Redis GUI 工具。
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;
import static org.junit.jupiter.api.Assertions.assertEquals;
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.
jedis.close();
}
}
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 回复
数组回复：指定范围内成员的列表，如果指定了 WITHSCORES 选项，则可选地包含其分数。历史
- 从 Redis 6.2.0 版本开始：添加了
REV、BYSCORE、BYLEX和LIMIT选项。