Golang Redis有序集合(sorted set)

标签：分数 set err 元素 Redis Golang client 集合 order1

Redis 有序集合（sorted set）和集合一样也是string类型元素的集合,且不允许重复的成员，不同的是每个元素都会关联一个double类型的分数，这个分数主要用于集合元素排序。

引用github库

"github.com/go-redis/redis/v8"

go redis有序集合常用函数:

1.ZAdd

添加一个或者多个元素到集合，如果元素已经存在则更新分数

// 添加一个集合元素到集合中， 这个元素的分数是当前时间戳，元素名是order1
    RedisClient.ZAdd(context.Background(), "pending",
		&redis.Z{
			Score:  float64(time.Now().Unix()),
			Member: "order1",
		})

下面是redis.Z结构体说明：

type Z struct {
	Score  float64 // 分数
	Member interface{} // 元素名
}

2.ZCard

返回集合元素个数

size, err := RedisClient.ZCard(context.Background(), "pending").Result()
fmt.Println(size, err)

3.ZCount

统计某个分数范围内的元素个数

// 返回： 0<=分数<=当前时间戳 的元素个数, 注意：min, max两个参数是字符串
size, err = RedisClient.ZCount(context.Background(), "pending", "0",
		strconv.FormatInt(time.Now().Unix(), 10)).Result()
fmt.Println(size, err)

// 返回： 0<=分数<=当前时间戳
// 说明：默认第二，第三个参数是大于等于和小于等于的关系。
// 如果加上（ 则表示大于或者小于，相当于去掉了等于关系。
size, err := client.ZCount("key", "(0",strconv.FormatInt(time.Now().Unix(), 10)).Result()

4.ZIncrBy

增加元素的分数

// 给元素order1，加上1分
RedisClient.ZIncrBy(context.Background(), "pending", 1, "order1")

5.ZRange,ZRevRange

返回集合中某个索引范围的元素，根据分数从小到大排序

// 返回从0到-1位置的集合元素， 元素按分数从小到大排序
// 0到-1代表则返回全部数据
vals, err := client.ZRange("pending", 0,-1).Result()
if err != nil {
	panic(err)
}

for _, val := range vals {
	fmt.Println(val)
}

ZRevRange用法跟ZRange一样，区别是ZRevRange的结果是按分数从大到小排序。

6.ZRangeByScore

根据分数范围返回集合元素，元素根据分数从小到大排序，支持分页。

// 初始化查询条件， Offset和Count用于分页
op := redis.ZRangeBy{
	Min:"2", // 最小分数
	Max:"10", // 最大分数
	Offset:0, // 类似sql的limit, 表示开始偏移量
	Count:5, // 一次返回多少数据
}
	
vals, err := client.ZRangeByScore("key", op).Result()
if err != nil {
	panic(err)
}

for _, val := range vals {
	fmt.Println(val)
}

7.ZRevRangeByScore

用法类似ZRangeByScore，区别是元素根据分数从大到小排序。

8.ZRangeByScoreWithScores

用法跟ZRangeByScore一样，区别是除了返回集合元素，同时也返回元素对应的分数

// 初始化查询条件， Offset和Count用于分页
op := redis.ZRangeBy{
	Min:"2", // 最小分数
	Max:"10", // 最大分数
	Offset:0, // 类似sql的limit, 表示开始偏移量
	Count:5, // 一次返回多少数据
}

vals, err := client.ZRangeByScoreWithScores("key", op).Result()
if err != nil {
	panic(err)
}

for _, val := range vals {
	fmt.Println(val.Member) // 集合元素
	fmt.Println(val.Score) // 分数
}

8.ZRem

删除集合元素

// 删除集合中的元素tizi
client.ZRem("pending", "order1")

// 删除集合中的元素tizi和xiaoli
// 支持一次删除多个元素
client.ZRem("key", "order1", "order2")

9.ZRemRangeByRank

根据索引范围删除元素

// 集合元素按分数排序，从最低分到高分，删除第0个元素到第5个元素。
// 这里相当于删除最低分的几个元素
client.ZRemRangeByRank("key", 0, 5)

// 位置参数写成负数，代表从高分开始删除。
// 这个例子，删除最高分数的两个元素，-1代表最高分数的位置，-2第二高分，以此类推。
client.ZRemRangeByRank("key", -1, -2)

10.ZRemRangeByScore

根据分数范围删除元素

// 删除范围： 2<=分数<=5 的元素
client.ZRemRangeByScore("key", "2", "5")

// 删除范围： 2<=分数<5 的元素
client.ZRemRangeByScore("key", "2", "(5")

11.ZScore

查询元素对应的分数

// 查询集合元素tizi的分数
score, _ := client.ZScore("key", "order1").Result()
fmt.Println(score)

12.ZRank

根据元素名，查询集合元素在集合中的排名，从0开始算，集合元素按分数从小到大排序

rk, _ := client.ZRank("key", "order1").Result()
fmt.Println(rk)

ZRevRank的作用跟ZRank一样，区别是ZRevRank是按分数从大到小排序。

标签：分数,set,err,元素,Redis,Golang,client,集合,order1
From： https://www.cnblogs.com/frankfud/p/16740889.html