Redis 集合(Set)

Redis 集合(Set)

Redis 的 Set 是 String 类型的无序集合。集合成员是唯一的，这就意味着集合中不能出现重复的数据。

集合对象的编码可以是 intset 或者 hashtable。

Redis 中集合是通过哈希表实现的，所以添加，删除，查找的复杂度都是 O(1)。

集合中最大的成员数为 ^{232 - 1} (4294967295, 每个集合可存储40多亿个成员)。

实例

> sadd job job1 job1 job2 job2 job3
3
> smembers job
job3
job2
job1

set常用命令

Sadd

Redis Sadd 命令将一个或多个成员元素加入到集合中，已经存在于集合的成员元素将被忽略。

假如集合 key 不存在，则创建一个只包含添加的元素作成员的集合。

当集合 key 不是集合类型时，返回一个错误。

语法

> SADD KEY_NAME VALUE1..VALUEN

返回值

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

实例

> sadd job job1 job1 job2 job2 job3
3
> smembers job
job3
job2
job1

Scard

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

语法

> SCARD KEY_NAME 

返回值

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

实例

> scard job
3

Sdiff

Redis Sdiff 命令返回第一个集合与其他集合之间的差异，也可以认为说第一个集合中独有的元素。

不存在的集合 key 将视为空集。

差集的结果来自前面的 FIRST_KEY ,而不是后面的 OTHER_KEY1，也不是整个 FIRST_KEY OTHER_KEY1..OTHER_KEYN 的差集。

语法

> SDIFF FIRST_KEY OTHER_KEY1..OTHER_KEYN 

返回值

包含差集成员的列表。

实例

> sadd set1 a b c d
4
> sadd set2 a b d f e
5
> sdiff set1 set2
c
> sdiff set2 set1
f
e

Sdiffstore

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

语法

> SDIFFSTORE DESTINATION_KEY KEY1..KEYN 

返回值

结果集中的元素数量。

实例

> sdiffstore set3 set2 set1
2
> smembers set3
f
e

Sismember

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

语法

> SISMEMBER KEY VALUE 

返回值

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

实例

> sismember set1 a
1
> sismember set1 f
0

Sinter

Redis Sinter 命令返回给定所有给定集合的交集。

不存在的集合 key 被视为空集。 当给定集合当中有一个空集时，结果也为空集(根据集合运算定律)。

语法

> SINTER KEY KEY1..KEYN 

返回值

交集成员的列表。

实例

> sinter set1 set2
d
a
b
 

Sinterstore

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

语法

> SINTERSTORE DESTINATION_KEY KEY KEY1..KEYN 

返回值

返回存储交集的集合的元素数量。

实例

> sinterstore set3 set1 set2
3
> smembers set3
a
d
b

Smembers

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

语法

>  SMEMBERS key

返回值

集合中的所有成员。

实例

> smembers set3
a
d
b

Smove

Redis 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 集合执行，那么返回 0 。

实例

> smove set2 set3 a
1

Spop

Redis Spop 命令用于移除集合中的指定 key 的一个或多个随机元素，移除后会返回移除的元素。

该命令类似 Srandmember命令，但 SPOP 将随机元素从集合中移除并返回，而 Srandmember 则仅仅返回随机元素，而不对集合进行任何改动。

语法

> SPOP key [count]

返回值

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

实例

> spop set2
e
> spop set2 2
f
b
> smembers set2
d

Srandmember

Redis Srandmember 命令用于返回集合中的一个随机元素。

从 Redis 2.6 版本开始， Srandmember 命令接受可选的 count 参数：

• 如果 count 为正数，且小于集合基数，那么命令返回一个包含 count 个元素的数组，数组中的元素各不相同。如果 count 大于等于集合基数，那么返回整个集合。
• 如果 count 为负数，那么命令返回一个数组，数组中的元素可能会重复出现多次，而数组的长度为 count 的绝对值。

该操作和 SPOP 相似，但 SPOP 将随机元素从集合中移除并返回，而 Srandmember 则仅仅返回随机元素，而不对集合进行任何改动。

语法

> SRANDMEMBER KEY [count]

返回值

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

实例

> srandmember set1
d
> smembers set1
d
a
c
b

Srem

Redis Srem 命令用于移除集合中的一个或多个成员元素，不存在的成员元素会被忽略。

当 key 不是集合类型，返回一个错误。

在 Redis 2.4 版本以前， SREM 只接受单个成员值。

语法

> SREM KEY MEMBER1..MEMBERN

返回值

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

实例

> smembers set1
d
a
c
b
> srem set1 d
1
> smembers set1
a
c
b

Sunion

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

语法

> SUNION KEY KEY1..KEYN

返回值

并集成员的列表。

实例

> sunion set1 set2
d
a
b
c

Sunionstore

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

语法

> SUNIONSTORE destination key [key ...]

返回值

结果集中的元素数量。

实例

> sunionstore set3 set1 set2
4
> smembers set3
d
a
b
c

Sscan

Redis Sscan 命令用于迭代集合中键的元素，Sscan 继承自 Scan

语法

> SSCAN key cursor [MATCH pattern] [COUNT count]

• cursor - 游标。
• pattern - 匹配的模式。
• count - 指定从数据集里返回多少元素，默认值为 10 。

返回值

数组列表。

实例

> sscan set3 0 match * count 2
2
d
a
> sscan set3 2 match * count 2
0
b
c