/* 未实现的列表方法: SSCAN */ package redisUtil import ( "github.com/gomodule/redigo/redis" ) /* SADD key member [member …] 可用版本: >= 1.0.0 时间复杂度: O(N), N 是被添加的元素的数量。 将一个或多个 member 元素加入到集合 key 当中,已经存在于集合的 member 元素将被忽略。 假如 key 不存在,则创建一个只包含 member 元素作成员的集合。 当 key 不是集合类型时,返回一个错误。 Note 在Redis2.4版本以前, SADD 只接受单个 member 值。 返回值 被添加到集合中的新元素的数量,不包括被忽略的元素。 */ func (this *RedisPool) SAdd(key string, values ...interface{}) (newCount int, err error) { conn := this.GetConnection() defer conn.Close() newCount, err = redis.Int(conn.Do("SADD", redis.Args{}.Add(key).AddFlat(values)...)) return } /* SISMEMBER key member 可用版本: >= 1.0.0 时间复杂度: O(1) 判断 member 元素是否集合 key 的成员。 返回值 如果 member 元素是集合的成员,返回 1 。 如果 member 元素不是集合的成员,或 key 不存在,返回 0 。 */ func (this *RedisPool) SIsMember(key string, value interface{}) (isMember bool, err error) { conn := this.GetConnection() defer conn.Close() isMember, err = redis.Bool(conn.Do("SISMEMBER", key, value)) return } /* SPOP key 可用版本: >= 1.0.0 时间复杂度: O(1) 移除并返回集合中的一个随机元素。 如果只想获取一个随机元素,但不想该元素从集合中被移除的话,可以使用 SRANDMEMBER key [count] 命令。 返回值 被移除的随机元素。 当 key 不存在或 key 是空集时,返回 nil 。 */ func (this *RedisPool) SPop(key string) (value interface{}, err error) { conn := this.GetConnection() defer conn.Close() value, err = conn.Do("SPOP", key) return } /* SRANDMEMBER key [count] 可用版本: >= 1.0.0 时间复杂度: 只提供 key 参数时为 O(1) 。如果提供了 count 参数,那么为 O(N) ,N 为返回数组的元素个数。 如果命令执行时,只提供了 key 参数,那么返回集合中的一个随机元素。 从 Redis 2.6 版本开始, SRANDMEMBER 命令接受可选的 count 参数: 如果 count 为正数,且小于集合基数,那么命令返回一个包含 count 个元素的数组,数组中的元素各不相同。如果 count 大于等于集合基数,那么返回整个集合。 如果 count 为负数,那么命令返回一个数组,数组中的元素可能会重复出现多次,而数组的长度为 count 的绝对值。 该操作和 SPOP key 相似,但 SPOP key 将随机元素从集合中移除并返回,而 SRANDMEMBER 则仅仅返回随机元素,而不对集合进行任何改动。 返回值 只提供 key 参数时,返回一个元素;如果集合为空,返回 nil 。 如果提供了 count 参数,那么返回一个数组;如果集合为空,返回空数组。 */ func (this *RedisPool) SRandMember(key string, count int) (reply interface{}, err error) { conn := this.GetConnection() defer conn.Close() reply, err = conn.Do("SRANDMEMBER", key, count) return } /* SREM key member [member …] 可用版本: >= 1.0.0 时间复杂度: O(N), N 为给定 member 元素的数量。 移除集合 key 中的一个或多个 member 元素,不存在的 member 元素会被忽略。 当 key 不是集合类型,返回一个错误。 Note 在 Redis 2.4 版本以前, SREM 只接受单个 member 值。 返回值 被成功移除的元素的数量,不包括被忽略的元素。 */ func (this *RedisPool) SRem(key string, values ...interface{}) (delCount int, err error) { conn := this.GetConnection() defer conn.Close() delCount, err = redis.Int(conn.Do("SREM", redis.Args{}.Add(key).AddFlat(values)...)) return } /* SMOVE source destination member 可用版本: >= 1.0.0 时间复杂度: O(1) 将 member 元素从 source 集合移动到 destination 集合。 SMOVE 是原子性操作。 如果 source 集合不存在或不包含指定的 member 元素,则 SMOVE 命令不执行任何操作,仅返回 0 。否则, member 元素从 source 集合中被移除,并添加到 destination 集合中去。 当 destination 集合已经包含 member 元素时, SMOVE 命令只是简单地将 source 集合中的 member 元素删除。 当 source 或 destination 不是集合类型时,返回一个错误。 返回值 如果 member 元素被成功移除,返回 1 。 如果 member 元素不是 source 集合的成员,并且没有任何操作对 destination 集合执行,那么返回 0 。 */ func (this *RedisPool) SMove(source, destination string, member interface{}) (successful bool, err error) { conn := this.GetConnection() defer conn.Close() var result int result, err = redis.Int(conn.Do("SMOVE", source, destination, member)) if err != nil { return } if result == 1 { successful = true } return } /* SCARD key 可用版本: >= 1.0.0 时间复杂度: O(1) 返回集合 key 的基数(集合中元素的数量)。 返回值 集合的基数。 当 key 不存在时,返回 0 。 */ func (this *RedisPool) SCard(key string) (nowCount int, err error) { conn := this.GetConnection() defer conn.Close() nowCount, err = redis.Int(conn.Do("SCARD", key)) return } /* SMEMBERS key 可用版本: >= 1.0.0 时间复杂度: O(N), N 为集合的基数。 返回集合 key 中的所有成员。 不存在的 key 被视为空集合。 返回值 集合中的所有成员。 */ func (this *RedisPool) SMembers(key string) (reply interface{}, err error) { conn := this.GetConnection() defer conn.Close() reply, err = conn.Do("SMEMBERS", key) return } /* SINTER key [key …] 可用版本: >= 1.0.0 时间复杂度: O(N * M), N 为给定集合当中基数最小的集合, M 为给定集合的个数。 返回一个集合的全部成员,该集合是所有给定集合的交集。 不存在的 key 被视为空集。 当给定集合当中有一个空集时,结果也为空集(根据集合运算定律)。 返回值 交集成员的列表。 */ func (this *RedisPool) SInter(key string, keyList ...string) (reply interface{}, err error) { conn := this.GetConnection() defer conn.Close() reply, err = conn.Do("SINTER", redis.Args{}.Add(key).AddFlat(keyList)...) return } /* SINTERSTORE destination key [key …] 可用版本: >= 1.0.0 时间复杂度: O(N * M), N 为给定集合当中基数最小的集合, M 为给定集合的个数。 这个命令类似于 SINTER key [key …] 命令,但它将结果保存到 destination 集合,而不是简单地返回结果集。 如果 destination 集合已经存在,则将其覆盖。 destination 可以是 key 本身。 返回值 结果集中的成员数量。 */ func (this *RedisPool) SInterStore(destination string, key string, keyList ...string) (count int, err error) { conn := this.GetConnection() defer conn.Close() count, err = redis.Int(conn.Do("SINTERSTORE", redis.Args{}.Add(destination).Add(key).AddFlat(keyList)...)) return } /* SUNION key [key …] 可用版本: >= 1.0.0 时间复杂度: O(N), N 是所有给定集合的成员数量之和。 返回一个集合的全部成员,该集合是所有给定集合的并集。 不存在的 key 被视为空集。 返回值 并集成员的列表。 */ func (this *RedisPool) SUnion(key string, keyList ...string) (reply interface{}, err error) { conn := this.GetConnection() defer conn.Close() reply, err = conn.Do("SUNION", redis.Args{}.Add(key).AddFlat(keyList)...) return } /* SUNIONSTORE destination key [key …] 可用版本: >= 1.0.0 时间复杂度: O(N), N 是所有给定集合的成员数量之和。 这个命令类似于 SUNION key [key …] 命令,但它将结果保存到 destination 集合,而不是简单地返回结果集。 如果 destination 已经存在,则将其覆盖。 destination 可以是 key 本身。 返回值 结果集中的元素数量。 */ func (this *RedisPool) SUnionStore(destination string, key string, keyList ...string) (count int, err error) { conn := this.GetConnection() defer conn.Close() count, err = redis.Int(conn.Do("SUNIONSTORE", redis.Args{}.Add(destination).Add(key).AddFlat(keyList)...)) return } /* SDIFF key [key …] 可用版本: >= 1.0.0 时间复杂度: O(N), N 是所有给定集合的成员数量之和。 返回一个集合的全部成员,该集合是所有给定集合之间的差集。 不存在的 key 被视为空集。 返回值 一个包含差集成员的列表。 */ func (this *RedisPool) SDiff(key string, keyList ...string) (reply interface{}, err error) { conn := this.GetConnection() defer conn.Close() reply, err = conn.Do("SDIFF", redis.Args{}.Add(key).AddFlat(keyList)...) return } /* SDIFFSTORE destination key [key …] 可用版本: >= 1.0.0 时间复杂度: O(N), N 是所有给定集合的成员数量之和。 这个命令的作用和 SDIFF key [key …] 类似,但它将结果保存到 destination 集合,而不是简单地返回结果集。 如果 destination 集合已经存在,则将其覆盖。 destination 可以是 key 本身。 返回值 结果集中的元素数量。 */ func (this *RedisPool) SDiffStore(destination string, key string, keyList ...string) (count int, err error) { conn := this.GetConnection() defer conn.Close() count, err = redis.Int(conn.Do("SDIFFSTORE", redis.Args{}.Add(destination).Add(key).AddFlat(keyList)...)) return }