西门小狼狗

Redis Set

1/10/2023 Redis

# Redis Set

# SADD key member [member...]

描述

添加一个或多个指定的member元素到集合的 key中.指定的一个或者多个元素member 如果已经在集合key中存在则忽略.如果集合key 不存在，则新建集合key,并添加member元素到集合key中.

如果key 的类型不是集合则返回错误.

返回值

返回新成功添加到集合里元素的数量，不包括已经存在于集合中的元素.

例子

127.0.0.1:6379> SADD zset a b c d a
(integer) 4
127.0.0.1:6379> SMEMBERS zset
1) "c"
2) "a"
3) "d"
4) "b"
1
2
3
4
5
6
7

# SMEMBERS key

描述

返回key集合所有的元素

该命令的作用与使用一个参数的SINTER (opens new window) 命令作用相同

返回值

集合中的所有元素

例子

127.0.0.1:6379> SMEMBERS zset
1) "c"
2) "a"
3) "d"
4) "b
1
2
3
4
5

# SISMEMBER key member

描述

返回成员 member 是否是存储的集合 key的成员

返回值

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

例子

127.0.0.1:6379> SMEMBERS zset
1) "c"
2) "a"
3) "d"
4) "b"
127.0.0.1:6379> SISMEMBER zset d
(integer) 1
1
2
3
4
5
6
7

# SCARD key

描述

返回集合存储的key的基数 (集合元素的数量).

返回值

集合的基数(元素的数量),如果key不存在,则返回 0

例子

127.0.0.1:6379> SCARD zset
(integer) 4
127.0.0.1:6379> SCARD zset1
(integer) 0
1
2
3
4

# SMOVE source destination member

描述

将member从source集合移动到destination集合中. 对于其他的客户端,在特定的时间元素将会作为source或者destination集合的成员出现.

如果source 集合不存在或者不包含指定的元素,这smove命令不执行任何操作并且返回0.否则对象将会从source集合中移除，并添加到destination集合中去，如果destination集合已经存在该元素，则smove命令仅将该元素充source集合中移除. 如果source 和destination不是集合类型,则返回错误.

# 返回值
  • 如果该元素成功移除,返回1
  • 如果该元素不是 source集合成员,无任何操作,则返回0.

例子

127.0.0.1:6379> SMEMBERS zset
1) "a"
2) "d"
3) "b"
4) "c"
127.0.0.1:6379> SMEMBERS zset1
1) "e"
2) "f"
3) "d"
127.0.0.1:6379> SMOVE zset zset1 a
(integer) 1
127.0.0.1:6379> SMEMBERS zset
1) "d"
2) "b"
3) "c"
127.0.0.1:6379> SMEMBERS zset1
1) "e"
2) "a"
3) "f"
4) "d"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# SPOP key [count]

描述

从存储在key的集合中移除并返回一个或多个随机元素。

此操作与SRANDMEMBER类似，它从一个集合中返回一个或多个随机元素，并不删除元素。

返回值

被删除的元素，或者当key不存在时返回nil。

例子

127.0.0.1:6379> SMEMBERS zset
1) "d"
2) "b"
3) "c"
127.0.0.1:6379> SPOP zset
"c"
127.0.0.1:6379> SMEMBERS zset
1) "b"
2) "d"
1
2
3
4
5
6
7
8
9

传递count时的行为规范

如果count大于集合内部的元素数量，此命令将会返回整个集合，不会有额外的元素。

# SRANDMEMBER key [count]

描述

仅提供key参数，那么随机返回key集合中的一个元素

Redis 2.6开始，可以接受 count 参数，如果count是整数且小于元素的个数，返回含有 count 个不同的元素的数组，如果count是个整数且大于集合中元素的个数时，仅返回整个集合的所有元素，当count是负数，则会返回一个包含count的绝对值的个数元素的数组，如果count的绝对值大于元素的个数，则返回的结果集里会出现一个元素出现多次的情况.

仅提供key参数时，该命令作用类似于SPOP命令，不同的是SPOP命令会将被选择的随机元素从集合中移除，而SRANDMEMBER仅仅是返回该随记元素，而不做任何操作.

返回值

不使用count 参数的情况下该命令返回随机的元素，如果key不存在则返回nil。

使用count参数,则返回一个随机的元素数组，如果key不存在则返回一个空的数组。

例子

127.0.0.1:6379> SMEMBERS zset
1) "b"
2) "d"
127.0.0.1:6379> SRANDMEMBER zset
"b"
127.0.0.1:6379> SRANDMEMBER zset
"b"
127.0.0.1:6379> SRANDMEMBER zset
"d"
127.0.0.1:6379> SRANDMEMBER zset
"d"
127.0.0.1:6379> SRANDMEMBER zset
"b"
127.0.0.1:6379> SRANDMEMBER zset 2
1) "b"
2) "d"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

传递count参数时的行为规范

当传递了一个值为正数的count参数，返回的元素就好像从集合中移除了每个选中的元素一样（就像在宾果游戏中提取数字一样）。但是元素不会从集合中移除。所以基本上：

  • 不会返回重复的元素。
  • 如果count参数的值大于集合内的元素数量，此命令将会仅返回整个集合，没有额外的元素。

相反，当count参数的值为负数时，此命令的行为将发生改变，并且提取操作就像在每次提取后，重新将取出的元素放回包里一样，因此，可能返回重复的元素，以及总是会返回我们请求的数量的元素，因为我们可以一次又一次地重复相同的元素，除了当集合为空（或者不存在key）的时候，将总是会返回一个空数组。

# SREM key member [member]

描述

在key集合中移除指定的元素. 如果指定的元素不是key集合中的元素则忽略 如果key集合不存在则被视为一个空的集合，该命令返回0.

如果key的类型不是一个集合,则返回错误

返回值

从集合中移除元素的个数，不包括不存在的成员.

例子

127.0.0.1:6379> SMEMBERS zset1
1) "e"
2) "a"
3) "f"
4) "d"
127.0.0.1:6379> SREM zset1 a e
(integer) 2
127.0.0.1:6379> SMEMBERS zset1
1) "f"
2) "d"
1
2
3
4
5
6
7
8
9
10

# SUNION key [key...]

描述

返回给定的多个集合的并集中的所有成员.

例如:

key1 = {a,b,c,d}
key2 = {c}
key3 = {a,c,e}
SUNION key1 key2 key3 = {a,b,c,d,e}
1
2
3
4

不存在的key可以认为是空的集合.

返回值

并集的成员列表

例子

127.0.0.1:6379> SMEMBERS zset1
1) "c"
2) "a"
3) "d"
4) "b"
127.0.0.1:6379> SMEMBERS zset2
1) "e"
2) "c"
3) "f"
4) "d"
127.0.0.1:6379> SUNION zset1 zset2
1) "c"
2) "e"
3) "b"
4) "a"
5) "d"
6) "f"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# SUNIONSTORE destination key [key...]

描述

该命令作用类似于SUNION (opens new window)命令,不同的是它并不返回结果集,而是将结果存储在destination集合中.

如果destination 已经存在,则将其覆盖

返回值

结果集中元素的个数.

例子

127.0.0.1:6379> SMEMBERS zset1
1) "c"
2) "a"
3) "d"
4) "b"
127.0.0.1:6379> SMEMBERS zset2
1) "e"
2) "c"
3) "f"
4) "d"
127.0.0.1:6379> SUNIONSTORE zset3 zset1 zset2
(integer) 6
127.0.0.1:6379> SMEMBERS zset3
1) "c"
2) "e"
3) "b"
4) "a"
5) "d"
6) "f"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# SDIFF key [key...]

描述

返回一个集合与给定集合的差集的元素.

例如:

key1 = {a,b,c,d}
key2 = {c}
key3 = {a,c,e}
SDIFF key1 key2 key3 = {b,d}
1
2
3
4

不存在的key可以认为是空的集合.

返回值

结果集的元素.

例子

127.0.0.1:6379> SMEMBERS zset1
1) "c"
2) "a"
3) "d"
4) "b"
127.0.0.1:6379> SMEMBERS zset2
1) "e"
2) "c"
3) "f"
4) "d"
127.0.0.1:6379> SDIFF zset1 zset2
1) "a"
2) "b"
127.0.0.1:6379> SDIFF zset2 zset1
1) "e"
2) "f"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# SDIFFSTORE destination key [key...]

描述

该命令类似于 SDIFF (opens new window), 不同之处在于该命令不返回结果集，而是将结果存放在destination集合中.

如果destination 已经存在,则将其覆盖

返回值

结果集中元素的个数.

例子

127.0.0.1:6379> SMEMBERS zset1
1) "c"
2) "a"
3) "d"
4) "b"
127.0.0.1:6379> SMEMBERS zset2
1) "e"
2) "c"
3) "f"
4) "d"
127.0.0.1:6379> SMEMBERS zset4
1) "a"
2) "b"
1
2
3
4
5
6
7
8
9
10
11
12
13

# SINTER key [key...]

描述

返回指定所有的集合的成员的交集

例如:

key1 = {a,b,c,d}
key2 = {c}
key3 = {a,c,e}
SINTER key1 key2 key3 = {c}
1
2
3
4

如果key不存在则被认为是一个空的集合,当给定的集合为空的时候,结果也为空.(一个集合为空，结果一直为空).

返回值

结果集成员的列表.

例子

127.0.0.1:6379> SMEMBERS zset1
1) "c"
2) "a"
3) "d"
4) "b"
127.0.0.1:6379> SMEMBERS zset2
1) "e"
2) "c"
3) "f"
4) "d"
127.0.0.1:6379> SINTER zset1 zset2
1) "c"
2) "d"
1
2
3
4
5
6
7
8
9
10
11
12
13

# SINTERSTORE destination key [key...]

描述

这个命令与SINTER (opens new window)命令类似, 但是它并不是直接返回结果集,而是将结果保存在 destination集合中.

如果destination 集合存在, 则会被重写.

返回值

结果集中元素的个数.

例子

127.0.0.1:6379> SMEMBERS zset1
1) "c"
2) "a"
3) "d"
4) "b"
127.0.0.1:6379> SMEMBERS zset2
1) "e"
2) "c"
3) "f"
4) "d"
127.0.0.1:6379> SINTERSTORE zset5 zset1 zset2
(integer) 2
127.0.0.1:6379> SMEMBERS zset5
1) "c"
2) "d"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Last Updated: 2/14/2023, 6:20:07 PM

Redis ZSet