Redis 有序集合(sorted set)和集合一样也是string类型元素的集合,且不允许重复的成员,不同的是每个元素都会关联一个double类型的分数,这个分数主要用于集合元素排序。
下面介绍golang redis 有序集合的用法
go redis有序集合常用函数:
ZAdd - 添加一个或者多个元素到集合,如果元素已经存在则更新分数
ZCard - 返回集合元素个数
ZCount - 统计某个分数范围内的元素个数
ZIncrBy - 增加元素的分数
ZRange,ZRevRange - 返回集合中某个索引范围的元素,根据分数从小到大排序
ZRangeByScore,ZRevRangeByScore - 根据分数范围返回集合元素,元素根据分数从小到大排序,支持分页。
ZRem - 删除集合元素
ZRemRangeByRank - 根据索引范围删除元素
ZRemRangeByScore - 根据分数范围删除元素
ZScore - 查询元素对应的分数
ZRank, ZRevRank - 查询元素的排名
1.ZAdd
添加一个或者多个元素到集合,如果元素已经存在则更新分数
// 添加一个集合元素到集合中, 这个元素的分数是2.5,元素名是tizi
err := client.ZAdd("key", redis.Z{2.5,"tizi"}).Err()
if err != nil {
panic(err)
}
下面是redis.Z结构体说明:
type Z struct {
Score float64 // 分数
Member interface{} // 元素名
}
2.ZCard
返回集合元素个数
size, err := client.ZCard("key").Result()
if err != nil {
panic(err)
}
fmt.Println(size)
3.ZCount
统计某个分数范围内的元素个数
// 返回: 1<=分数<=5 的元素个数, 注意:"1", "5"两个参数是字符串
size, err := client.ZCount("key", "1","5").Result()
if err != nil {
panic(err)
}
fmt.Println(size)
// 返回: 1<分数<=5 的元素个数
// 说明:默认第二,第三个参数是大于等于和小于等于的关系。
// 如果加上( 则表示大于或者小于,相当于去掉了等于关系。
size, err := client.ZCount("key", "(1","5").Result()
4.ZIncrBy
增加元素的分数
// 给元素5,加上2分
client.ZIncrBy("key", 2,"5")
5.ZRange,ZRevRange
返回集合中某个索引范围的元素,根据分数从小到大排序
// 返回从0到-1位置的集合元素, 元素按分数从小到大排序
// 0到-1代表则返回全部数据
vals, err := client.ZRange("key", 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("key", "tizi")
// 删除集合中的元素tizi和xiaoli
// 支持一次删除多个元素
client.ZRem("key", "tizi", "xiaoli")
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", "tizi").Result()
fmt.Println(score)
12.ZRank
根据元素名,查询集合元素在集合中的排名,从0开始算,集合元素按分数从小到大排序
rk, _ := client.ZRank("key", "tizi").Result()
fmt.Println(rk)
ZRevRank的作用跟ZRank一样,区别是ZRevRank是按分数从大到小排序。
网友评论