SADD key member

将member元素加入到集合key当中。

如果member元素已经是该集合的成员，那SADD命令不执行任何操作。

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

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

时间复杂度:

O(1)

返回值:

如果添加元素成功，返回1。

如果元素已经是集合的成员，返回0。

Redis代码  

1. <span style="font-size: small;">redis> SADD bbs "v2ex.com"

2. (integer) 1

3. redis> SADD bbs "codecompo.com"

4. (integer) 1

5. redis> SMEMBERS bbs     # 显示bbs集合中所有成员

6. 1) "codecompo.com"

7. 2) "v2ex.com"

8. redis> SADD bbs "v2ex.com"  # 尝试添加重复元素，返回0

9. (integer) 0</span>

SINTER key [key ...]

返回一个集合的全部成员，该集合是所有给定集合的交集。

不存在的key被视为空集。

当给定集合当中有一个空集时，结果也为空集（根据集合运算定律）。

时间复杂度:

O(N * M)，N为给定集合当中基数最小的集合，M为给定集合的个数。

返回值:

交集成员的列表。

Redis代码  

1. <span style="font-size: small;">redis> SMEMBERS group_1

2. 1) "LI LEI"

3. 2) "TOM"

4. 3) "JACK"   # <-

5. redis> SMEMBERS group_2

6. 1) "HAN MEIMEI"

7. 2) "JACK"   # <-

8. redis> SINTER group_1 group_2

9. 1) "JACK"</span>

SMOVE source destination member

将member元素从source集合移动到destination集合。

SMOVE是原子性操作。

如果source集合不存在或不包含指定的member元素，则SMOVE命令不执行任何操作，仅返回0。否则，member元素从source集合中被移除，并添加到destination集合中去。

当destination集合已经包含member元素时，SMOVE命令只是简单地将source集合中的member元素删除。

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

复杂度:

O(1)

返回值:

如果member元素被成功移除，返回1。

如果member元素不是source集合的成员，并且没有任何操作对destination集合执行，那么返回0。

Redis代码  

1. redis> SMEMBERS songs

2. 1) "Billie Jean"

3. 2) "Believe Me"

4. redis> SMEMBERS my_songs

5. (empty list or set)

6. redis> SMOVE songs my_songs "Believe Me"

7. (integer) 1

8. redis> SMEMBERS songs

9. 1) "Billie Jean"

10. redis> SMEMBERS my_songs

11. 1) "Believe Me"

SUNION key [key ...]

返回一个集合的全部成员，该集合是所有给定集合的并集。

不存在的key被视为空集。

复杂度:

O(N)，N是所有给定集合的成员数量之和。

返回值:

并集成员的列表。

Redis代码  

1. redis> SMEMBERS songs

2. 1) "Billie Jean"

3. redis> SMEMBERS my_songs

4. 1) "Believe Me"

5. redis> SUNION songs my_songs

6. 1) "Billie Jean"

7. 2) "Believe Me"

SCARD key

返回集合的基数（集合中元素的数量）。

复杂度:

O(1)

返回值：

集合的基数。

当key不存在时，返回0。

Redis代码  

1. redis> SMEMBERS tool

2. 1) "pc"

3. 2) "printer"

4. 3) "phone"

5. redis> SCARD tool

6. (integer) 3

7. redis> SMEMBERS fake_set

8. (empty list or set)

9. redis> SCARD fake_set

10. (integer) 0

SINTERSTORE destination key [key ...]

此命令等同于SINTER，但它将结果保存到destination集合，而不是简单地返回结果集。

如果destination集合已经存在，则将其覆盖。

时间复杂度:

O(N * M)，N为给定集合当中基数最小的集合，M为给定集合的个数。

返回值:

结果集中的元素数量。

Redis代码  

1. redis> SMEMBERS songs

2. 1) "good bye joe"   # <-

3. 2) "hello,peter"

4. redis> SMEMBERS my_songs

5. 1) "good bye joe"   # <-

6. 2) "falling"

7. redis> SINTERSTORE song_and_my_song songs my_songs

8. (integer) 1

9. redis> SMEMBERS song_and_my_song

10. 1) "good bye joe"

SPOP key

移除并返回集合中的一个随机元素。

复杂度:

O(1)

返回值:

被移除的随机元素。

当key不存在或key是空集时，返回nil。

Redis代码  

1. redis> SMEMBERS my_sites

2. 1) "huangz.iteye.com"

3. 2) "sideeffect.me"

4. 3) "douban.com/people/i_m_huangz"

5. redis> SPOP my_sites

6. "huangz.iteye.com"

7. redis> SMEMBERS my_sites

8. 1) "sideeffect.me"

9. 2) "douban.com/people/i_m_huang"

SUNIONSTORE destination key [key ...]

此命令等同于SUNION，但它将结果保存到destination集合，而不是简单地返回结果集。

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

复杂度:

O(N)，N是所有给定集合的成员数量之和。

返回值:

结果集中的元素数量。

Redis代码  

1. redis> SMEMBERS ms_sites

2. 1) "microsoft.com"

3. 2) "skype.com"

4. redis> SMEMBERS google_sites

5. 1) "youtube.com"

6. 2) "google.com"

7. redis> SUNIONSTORE google_and_ms_sites ms_sites google_sites

8. (integer) 4

9. redis> SMEMBERS google_and_ms_sites

10. 1) "microsoft.com"

11. 2) "skype.com"

12. 3) "google.com"

13. 4) "youtube.com"

SDIFF key [key ...]

返回一个集合的全部成员，该集合是第一个给定集合和其他所有给定集合的差集 。

不存在的key被视为空集。

复杂度:

O(N)，N是所有给定集合的成员数量之和。

返回值:

交集成员的列表。

Redis代码  

1. redis> SMEMBERS peter's_movies

2. 1) "bet man"

3. 2) "start war"

4. 3) "2012"   # <-

5. redis> SMEMBERS joe's_movies

6. 1) "hi, lady"

7. 2) "Fast Five"

8. 3) "2012"   # <-

9. redis> SDIFF peter's_movies joe's_movies

10. 1) "bet man"

11. 2) "start war"

SISMEMBER key member

判断member元素是否是集合的成员。

时间复杂度:

O(1)

返回值:

如果member元素是集合的成员，返回1。

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

Redis代码  

1. redis> SMEMBERS joe's_movies

2. 1) "hi, lady"

3. 2) "Fast Five"

4. 3) "2012"

5. redis> SISMEMBER joe's_movies "bet man"

6. (integer) 0

7. redis> SISMEMBER joe's_movies "Fast Five"

8. (integer) 1

SRANDMEMBER key

返回集合中的一个随机元素。

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

时间复杂度:

O(1)

返回值:

被选中的随机元素。 当key不存在或key是空集时，返回nil。

Redis代码  

1. redis> SMEMBERS joe's_movies

2. 1) "hi, lady"

3. 2) "Fast Five"

4. 3) "2012"

5. redis> SRANDMEMBER joe's_movies

6. "Fast Five"

7. redis> SMEMBERS joe's_movies    # 集合中的元素不变

8. 1) "hi, lady"

9. 2) "Fast Five"

10. 3) "2012"

SDIFFSTORE destination key [key ...]

此命令等同于SDIFF，但它将结果保存到destination集合，而不是简单地返回结果集。

如果destination集合已经存在，则将其覆盖。

复杂度:

O(N)，N是所有给定集合的成员数量之和。

返回值:

结果集中的元素数量。

Redis代码  

1. redis> SMEMBERS joe's_movies

2. 1) "hi, lady"

3. 2) "Fast Five"

4. 3) "2012"

5. redis> SMEMBERS peter's_movies

6. 1) "bet man"

7. 2) "start war"

8. 3) "2012"

9. redis> SDIFFSTORE joe_diff_peter joe's_movies peter's_movies

10. (integer) 2

11. redis> SMEMBERS joe_diff_peter

12. 1) "hi, lady"

13. 2) "Fast Five"

SMEMBERS key

返回集合中的所有成员。

时间复杂度:

O(N)，N为集合的基数。

返回值:

集合中的所有成员。

Redis代码  

1. redis> SMEMBERS prog_lang

2. 1) "c"

3. 2) "ruby"

4. 3) "python"

SREM key member

移除集合中的member元素。

如果member元素不是集合中的成员，则SREM命令不执行任何操作。

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

时间复杂度:

O(1)

返回值:

如果移除元素成功，返回1。

如果member元素不是集合成员，返回0。

Redis代码  

1. redis> SMEMBERS prog_lang

2. 1) "c"

3. 2) "ruby"

4. 3) "python"

5. redis> SREM prog_lang "c"

6. (integer) 1

7. redis> SMEMBERS prog_lang

8. 1) "ruby"

9. 2) "python"

10. redis> SREM prog_lang "scheme"

11. (integer) 0

12. redis> SMEMBERS prog_lang

13. 1) "ruby"

14. 2) "python"