redis-5-set

/ Database / 没有评论 / 1924浏览

指令介绍

键指令作用例子返回值序号
SADD将一个或多个成员元素加入到集合中,已经存在于集合的成员元素将被忽略,假如集合 key 不存在,则创建一个只包含添加的元素作成员的集合SADD KEY_NAME VALUE1..VALUEN被添加到集合中的新元素的数量,不包括被忽略的元素0
SCARD返回集合中元素的数量SCARD KEY_NAME集合的数量。 当集合 key 不存在时,返回 01
SDIFF返回第一个集合与其他集合之间的差异,也可以认为说第一个集合中独有的元素。不存在的集合 key 将视为空集, 差集的结果来自前面的 FIRST_KEY ,而不是后面的 OTHER_KEY1,也不是整个 FIRST_KEY OTHER_KEY1..OTHER_KEYN 的差集SDIFF FIRST_KEY OTHER_KEY1..OTHER_KEYN包含差集成员的列表2
SDIFFSTORE将给定集合之间的差集(SDIFF指令的输出)存储在指定的集合中。如果指定的集合 key 已存在,则会被覆盖SDIFFSTORE DESTINATION_KEY KEY1..KEYN结果集中的元素数量3
SINTER返回给定所有给定集合的交集。 不存在的集合 key 被视为空集。 当给定集合当中有一个空集时,结果也为空集(根据集合运算定律)SINTER KEY KEY1..KEYN交集成员的列表4
SINTERSTORE将给定集合之间的交集存储在指定的集合中。如果指定的集合已经存在,则将其覆盖SINTERSTORE DESTINATION_KEY KEY KEY1..KEYN返回存储交集的集合的元素数量5
SISMEMBER判断成员元素是否是集合的成员SISMEMBER KEY VALUE如果成员元素是集合的成员,返回 1 。 如果成员元素不是集合的成员,或 key 不存在,返回 06
SMEMBERS返回集合中的所有的成员。 不存在的集合 key 被视为空集合SMEMBERS key集合中的所有成员7
SMOVE将指定成员 member 元素从 source 集合移动到 destination 集合。SMOVE 是原子性操作。如果 source 集合不存在或不包含指定的 member 元素,则 SMOVE 命令不执行任何操作,仅返回 0 。否则, member 元素从 source 集合中被移除,并添加到 destination 集合中去。当 destination 集合已经包含 member 元素时, SMOVE 命令只是简单地将 source 集合中的 member 元素删除。当 source 或 destination 不是集合类型时,返回一个错误SMOVE SOURCE DESTINATION MEMBER如果成员元素被成功移除,返回 1 。 如果成员元素不是 source 集合的成员,并且没有任何操作对 destination 集合执行,那么返回 08
SPOP用于移除集合中的指定 key 的一个或多个随机元素,移除后会返回移除的元素。该命令类似 Srandmember 命令,但 SPOP 将随机元素从集合中移除并返回,而 Srandmember 则仅仅返回随机元素,而不对集合进行任何改动SPOP KEY_NAME [count]被移除的随机元素。 当集合不存在或是空集时,返回 nil9
SRANDMEMBER于返回集合中的一个随机元素。从 Redis 2.6 版本开始, Srandmember 命令接受可选的 count 参数:如果 count 为正数,且小于集合基数,那么命令返回一个包含 count 个元素的数组,数组中的元素各不相同。如果 count 大于等于集合基数,那么返回整个集合。 如果 count 为负数,那么命令返回一个数组,数组中的元素可能会重复出现多次,而数组的长度为 count 的绝对值。该操作和 SPOP 相似,但 SPOP 将随机元素从集合中移除并返回,而 Srandmember 则仅仅返回随机元素,而不对集合进行任何改动SRANDMEMBER KEY [count]只提供集合 key 参数时,返回一个元素;如果集合为空,返回 nil 。 如果提供了 count 参数,那么返回一个数组;如果集合为空,返回空数组10
SREM用于移除集合中的一个或多个成员元素,不存在的成员元素会被忽略。当 key 不是集合类型,返回一个错误。 在 Redis 2.4 版本以前, SREM 只接受单个成员值SREM KEY MEMBER1..MEMBERN被成功移除的元素的数量,不包括被忽略的元素11
SUNION返回给定集合的并集。不存在的集合 key 被视为空集SUNION KEY KEY1..KEYN并集成员的列表12
SUNIONSTORE将给定集合的并集存储在指定的集合 destination 中。如果 destination 已经存在,则将其覆盖SUNIONSTORE destination key [key ...]结果集中的元素数量13
SSCAN用于迭代集合中键的元素,Sscan 继承自 ScanSSCAN key cursor [MATCH pattern] [COUNT count]数组列表14

代码实践

SADD

	res,err := RedisClient.SAdd(ctx,"set","lijinghua","limeihua").Result()
	if err != nil {
		logrus.Error(err) // 如果key存在,则覆盖
		return
	}
	logrus.Info(res) // 返回成功写入的元素,已存在的不在返回内容内

SCARD

	res,err := RedisClient.SCard(ctx,"set").Result()
	if err != nil {
		logrus.Error(err) // 如果key不存在,不报错
		return
	}
	logrus.Info(res) // 返回元素的个数,如果key不存在,返回0

SDIFF

	res,err := RedisClient.SDiff(ctx,"set","set1").Result()
	if err != nil {
		logrus.Error(err) // 如果2个key都不存在,不报错
		return
	}
	logrus.Info(res) // 返回第一个key独有的元素

SDIFFSTORE

	res, err := RedisClient.SDiffStore(ctx, "set-diff", "set", "set1").Result()
	if err != nil {
		logrus.Error(err) // 如果2个key都不存在,不报错
		return
	}
	logrus.Info(res) // 返回SDiff的元素个数,对比的两个key都不存在,返回0

SINTER

	res, err := RedisClient.SInter(ctx, "set", "set1").Result()
	if err != nil {
		logrus.Error(err) // 如果2个key都不存在,不报错
		return
	}
	logrus.Info(res) // 返回SInter求交集的结果,对比的两个key都不存在,返回0

SInterStore

	res, err := RedisClient.SInterStore(ctx, "set112", "set","set1").Result()
	if err != nil {
		logrus.Error(err) // 如果2个key都不存在,不报错
		return
	}
	logrus.Info(res) // 返回SInter求交集的结果,对比的两个key都不存在,返回0

SISMEMBER

	res, err := RedisClient.SIsMember(ctx, "set1112", "lijinghua").Result()
	if err != nil {
		logrus.Error(err) // 如果key不存在,不报错
		return
	}
	logrus.Info(res) // 如果存在,则返回true,否则返回false

SMEMBERS

	res, err := RedisClient.SMembers(ctx, "set1111").Result()
	if err != nil {
		logrus.Error(err) // 如果key不存在,不报错
		return
	}
	logrus.Info(res) // 正常情况下返回元素的数组列表,如果key不存在或者元素为空,返回空数组

SMove

	res, err := RedisClient.SMove(ctx, "set1","set","user1").Result()
	if err != nil {
		logrus.Error(err) // 如果目标key不存在,会创建,不报错
		return
	}
	logrus.Info(res) // 正常情况下返回成功移动source key中的元素到目标key的元素个数,尽管目标key中已包含要移动的元素,但是source key会删除要移动的元素

SPop

res, err := RedisClient.SPop(ctx, "set1").Result()
if err != nil {
   logrus.Error(err) // 如果目标key不存在,会报错
   return
}
logrus.Info(res) // 正常情况下返回成功随机出来并删除的元素

SRandMember

res, err := RedisClient.SRandMember(ctx, "set").Result()
if err != nil {
   logrus.Error(err) // 如果目标key不存在,报错 nil
   return
}
logrus.Info(res) // 正常情况下返回随机出来的元素

SRandMemberN

	res, err := RedisClient.SRandMemberN(ctx, "se12t11",2).Result()
	if err != nil {
		logrus.Error(err) // 如果目标key不存在,不报错
		return
	}
	logrus.Info(res) // 正常情况下返回N个随机出来的元素,如果只有count个元素,则每次返回数据一样

SREM

	res, err := RedisClient.SRem(ctx, "set11","1111","2222").Result()
	if err != nil {
		logrus.Error(err) // 如果目标key不存在,不报错,返回0
		return
	}
	logrus.Info(res) // 正常情况下返回移除的元素个数

SUNION

	res, err := RedisClient.SUnion(ctx, "set","set1","set121").Result()
	if err != nil {
		logrus.Error(err) // 如果目标key都不存在,不报错
		return
	}
	logrus.Info(res) // 正常情况下返回所有目标的并集结果

SUNIONSTORE

	res, err := RedisClient.SUnionStore(ctx, "set","11111","1111111").Result()
	if err != nil {
		logrus.Error(err) // 如果目标key都不存在,不报错
		return
	}
	logrus.Info(res) // 正常情况下返回所有目标的并集结果,destination key在有并集结果和没并集结果的情况下,都会被清空

SSCAN

	res, cursor, err := RedisClient.SScan(ctx, "set",0,"*jinghua*",10).Result()
	if err != nil {
		logrus.Error(err) // 如果目标key都不存在,不报错
		return
	}
	logrus.Warn(cursor)
	logrus.Info(res) // 正常情况下返回所有匹配的元素组成的数组