12 Redis 集合(Set)

Redis的Set是string类型的无序集合。集合成员是唯一的，这就意味着集合中不能出现重复的数据。
Redis 中 集合是通过哈希表实现的，所以添加，删除，查找的复杂度都是O(1)。
集合中最大的成员数为 232 - 1 (4294967295, 每个集合可存储40多亿个成员)。

• 实例

127.0.0.1:6379> SADD runoobkey redis
(integer) 1
127.0.0.1:6379> SADD runoobkey mongodb
(integer) 1
127.0.0.1:6379> SADD runoobkey mysql
(integer) 1
127.0.0.1:6379> SADD runoobkey mysql
(integer) 0
127.0.0.1:6379> SMEMBERS runoobkey
1) "mysql"
2) "redis"
3) "mongodb"

在以上实例中我们通过 SADD 命令向名为 runoobkey 的集合插入的三个元素。

Redis 集合命令

下表列出了 Redis 集合基本命令：

• 1 Sadd

Redis Sadd 命令将一个或多个成员元素加入到集合中，已经存在于集合的成员元素将被忽略。
假如集合 key 不存在，则创建一个只包含添加的元素作成员的集合。
当集合 key 不是集合类型时，返回一个错误。
注意：在Redis2.4版本以前， SADD 只接受单个成员值。

# 语法
redis 127.0.0.1:6379> SADD KEY_NAME VALUE1..VALUEN


# 返回值
被添加到集合中的新元素的数量，不包括被忽略的元素。


# 实例
127.0.0.1:6379> SADD myset "hello"
(integer) 1
127.0.0.1:6379> SADD myset "foo"
(integer) 1
127.0.0.1:6379> SADD myset "hello"
(integer) 0
127.0.0.1:6379> SMEMBERS myset
1) "hello"
2) "foo"

• 2 Scard

Redis Scard 命令返回集合中元素的数量。

# 语法
redis 127.0.0.1:6379> SCARD KEY_NAME 


# 返回值
集合的数量。 当集合 key 不存在时，返回 0 。


# 实例

127.0.0.1:6379> SADD myset "hello"
(integer) 1
127.0.0.1:6379> SADD myset "foo"
(integer) 1
127.0.0.1:6379> scard myset
(integer) 2

• 3 Sdiff

Redis Sdiff 命令返回给定集合之间的差集。不存在的集合 key 将视为空集。

# 语法
redis 127.0.0.1:6379> SDIFF FIRST_KEY OTHER_KEY1..OTHER_KEYN 


# 返回值
包含差集成员的列表。


# 实例
127.0.0.1:6379> SADD myset "hello"
(integer) 1
127.0.0.1:6379> SADD myset "foo"
(integer) 1
127.0.0.1:6379> SADD myset "bar"
(integer) 1
127.0.0.1:6379>  SADD myset2 "hello"
(integer) 1
127.0.0.1:6379> SADD myset2 "world"
(integer) 1
127.0.0.1:6379> SDIFF myset myset2
1) "foo"
2) "bar"
127.0.0.1:6379> SDIFF myset2 myset
1) "world"

• 4 Sdiffstore

Redis Sdiffstore 命令将给定集合之间的差集存储在指定的集合中。如果指定的集合 key 已存在，则会被覆盖。

# 语法
redis 127.0.0.1:6379> SDIFFSTORE DESTINATION_KEY KEY1..KEYN 


# 返回值
结果集中的元素数量。


# 实例

# 对已存在的键进行设置
127.0.0.1:6379> SADD myset "hello"
(integer) 1
127.0.0.1:6379> SADD myset "foo"
(integer) 1
127.0.0.1:6379> SADD myset "bar"
(integer) 1

127.0.0.1:6379>  SADD myset2 "hello"
(integer) 1
127.0.0.1:6379> SADD myset2 "world"
(integer) 1

127.0.0.1:6379> SDIFFSTORE destset myset myset2
(integer) 2
127.0.0.1:6379> SMEMBERS destset
1) "foo"
2) "bar"

127.0.0.1:6379> SDIFFSTORE destset2 myset2 myset
(integer) 1
127.0.0.1:6379> SMEMBERS destset2
1) "world"

• 5 Sinter

Redis Sinter 命令返回给定所有给定集合的交集。 不存在的集合 key 被视为空集。 当给定集合当中有一个空集时，结果也为空集(根据集合运算定律)。

# 语法
redis 127.0.0.1:6379> SINTER KEY KEY1..KEYN 


# 返回值
在 Redis 2.6.12 以前版本， SET 命令总是返回 OK 。


# 实例
127.0.0.1:6379> SADD myset "hello"
(integer) 1
127.0.0.1:6379> SADD myset "foo"
(integer) 1
127.0.0.1:6379> SADD myset "bar"
(integer) 1

127.0.0.1:6379>  SADD myset2 "hello"
(integer) 1
127.0.0.1:6379> SADD myset2 "world"
(integer) 1

127.0.0.1:6379> SINTER myset myset2
1) "hello"
127.0.0.1:6379> SINTER myset2 myset
1) "hello"

• 6 Sinterstore

Redis Sinterstore 命令将给定集合之间的交集存储在指定的集合中。如果指定的集合已经存在，则将其覆盖。

# 语法
redis 127.0.0.1:6379> SINTERSTORE DESTINATION_KEY KEY KEY1..KEYN 


# 返回值
指定集合的元素数量


# 实例
127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "foo"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1

127.0.0.1:6379>  SADD myset2 "hello"
(integer) 1
127.0.0.1:6379> SADD myset2 "world"
(integer) 1

127.0.0.1:6379> SINTERSTORE myset myset1 myset2
(integer) 1
127.0.0.1:6379> SMEMBERS myset
1) "hello"

• 7 Sismember

Redis Sismember 命令判断成员元素是否是集合的成员。

# 语法
redis 127.0.0.1:6379> SISMEMBER KEY VALUE 

# 返回值
如果成员元素是集合的成员，返回 1 。 如果成员元素不是集合的成员，或 key 不存在，返回 0 。


# 实例
127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "foo"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1

127.0.0.1:6379> SISMEMBER myset1 "666"
(integer) 0
127.0.0.1:6379> SISMEMBER myset1 "hello"
(integer) 1

• 8 Smembers

Redis Smembers 命令返回集合中的所有的成员。 不存在的集合 key 被视为空集合。

# 语法
redis 127.0.0.1:6379> SMEMBERS KEY VALUE 


# 返回值
集合中的所有成员。


# 实例
127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "world"
(integer) 1
127.0.0.1:6379> SMEMBERS myset1
1) "hello"
2) "world"

• 9 Smove

Redis Smove 命令将指定成员 member 元素从 source 集合移动到 destination 集合。
SMOVE 是原子性操作。
如果 source 集合不存在或不包含指定的 member 元素，则 SMOVE 命令不执行任何操作，仅返回 0 。否则， member 元素从 source 集合中被移除，并添加到 destination 集合中去。
当 destination 集合已经包含 member 元素时， SMOVE 命令只是简单地将 source 集合中的 member 元素删除。
当 source 或 destination 不是集合类型时，返回一个错误。

# 语法
redis 127.0.0.1:6379> SMOVE SOURCE DESTINATION MEMBER 


# 返回值
如果成员元素被成功移除，返回 1 。 如果成员元素不是 source 集合的成员，并且没有任何操作对 destination 集合执行，那么返回 0 。


# 实例

# 对已存在的键进行设置
127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "world"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1
127.0.0.1:6379> SADD myset2 "foo"
(integer) 1
127.0.0.1:6379> SMOVE myset1 myset2 "bar"
(integer) 1
127.0.0.1:6379> SMEMBERS myset1
1) "hello"
2) "world"
127.0.0.1:6379> SMEMBERS myset2
1) "foo"
2) "bar"

• 10 Spop

Redis Spop 命令用于移除并返回集合中的一个随机元素。

# 语法
redis 127.0.0.1:6379> SPOP KEY 


# 返回值
在被移除的随机元素。 当集合不存在或是空集时，返回 nil 。


# 实例
127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "world"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1
127.0.0.1:6379> SPOP myset1
"hello"
127.0.0.1:6379> SMEMBERS myset1
1) "bar"
2) "world"

• 11 Srandmember

Redis Srandmember 命令用于返回集合中的一个随机元素。
从 Redis 2.6 版本开始， Srandmember 命令接受可选的 count 参数：
1): 如果 count 为正数，且小于集合基数，那么命令返回一个包含 count 个元素的数组，数组中的元素各不相同。如果 count 大于等于集合基数，那么返回整个集合。

2): 如果 count 为负数，那么命令返回一个数组，数组中的元素可能会重复出现多次，而数组的长度为 count 的绝对值。
该操作和 SPOP 相似，但 SPOP 将随机元素从集合中移除并返回，而 Srandmember 则仅仅返回随机元素，而不对集合进行任何改动。

# 语法
redis 127.0.0.1:6379> SRANDMEMBER KEY [count]


# 返回值
只提供集合 key 参数时，返回一个元素；如果集合为空，返回 nil 。 如果提供了 count 参数，那么返回一个数组；如果集合为空，返回空数组。


# 实例
127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "world"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1
127.0.0.1:6379> SRANDMEMBER myset1
"hello"
127.0.0.1:6379> SRANDMEMBER myset1
"bar"
127.0.0.1:6379> SRANDMEMBER myset1
"bar"
127.0.0.1:6379> SRANDMEMBER myset1 2
1) "hello"
2) "bar"

• 12 Srem

Redis Srem 命令用于移除集合中的一个或多个成员元素，不存在的成员元素会被忽略。
当 key 不是集合类型，返回一个错误。
在 Redis 2.4 版本以前， SREM 只接受单个成员值。

# 语法
redis 127.0.0.1:6379> SREM KEY MEMBER1..MEMBERN


# 返回值
被成功移除的元素的数量，不包括被忽略的元素。


# 实例
127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "world"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1
127.0.0.1:6379> SRANDMEMBER myset1
"hello"
127.0.0.1:6379> SRANDMEMBER myset1
"bar"
127.0.0.1:6379> SRANDMEMBER myset1
"bar"
127.0.0.1:6379> SRANDMEMBER myset1 2
1) "hello"
2) "bar"

• 13 Sunion

Redis Sunion 命令返回给定集合的并集。不存在的集合 key 被视为空集。

# 语法
redis 127.0.0.1:6379> SUNION KEY KEY1..KEYN


# 返回值
并集成员的列表。


# 实例
127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> SADD key1 "a"
(integer) 1
127.0.0.1:6379> SADD key1 "b"
(integer) 1
127.0.0.1:6379> SADD key1 "c"
(integer) 1
127.0.0.1:6379> SADD key2 "c"
(integer) 1
127.0.0.1:6379> SADD key2 "d"
(integer) 1
127.0.0.1:6379> SADD key2 "e"
(integer) 1
127.0.0.1:6379> SUNION key1 key2
1) "b"
2) "a"
3) "c"
4) "d"
5) "e"

• 14 Sunionstore

Redis Sunionstore 命令将给定集合的并集存储在指定的集合 destination 中。如果 destination 已经存在，则将其覆盖。

# 语法
redis 127.0.0.1:6379> SUNIONSTORE DESTINATION KEY KEY1..KEYN


# 返回值
结果集中的元素数量。


# 实例
127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "world"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1

127.0.0.1:6379> SADD myset2 "hello"
(integer) 1
127.0.0.1:6379> SADD myset2 "bar"
(integer) 1
127.0.0.1:6379> SADD myset2 "foo"
(integer) 1

127.0.0.1:6379> SUNIONSTORE myset myset1 myset2
(integer) 4
127.0.0.1:6379> SMEMBERS myset
1) "hello"
2) "foo"
3) "world"
4) "bar"

• 15 Sscan

Redis Sscan 命令用于迭代集合键中的元素。

# 语法
SSCAN key cursor [MATCH pattern] [COUNT count]


# 返回值
数组列表。


# 实例
127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "hi"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1
127.0.0.1:6379> sscan myset1 0 match h*
1) "0"
2) 1) "hi"
   2) "hello"