Redis命令详解-Set

1.sadd key member member``````

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

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

返回值

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

历史

  • >= 2.4: 接受多个member参数. Redis 2.4 以前的版本每次只能添加一个member元素.
Redis命令详解-Set



2.scard key

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

返回值

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

Redis命令详解-Set


3.sdiff key key key``````

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

举例:

key1 = {a,b,c,d}
key2 = {c}
key3 = {a,c,e}
SDIFF key1 key2 key3 = {b,d}

不存在的key认为是空集.

返回值

Multi-bulk reply:结果集的元素.

Redis命令详解-Set


4.sdiffstore storekey key1 key2`````

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

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

返回值

返回整数: 结果集元素的个数.

Redis命令详解-Set


5.sinter key1 key2 `````

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

例如:

key1 = {a,b,c,d}
key2 = {c}
key3 = {a,c,e}
SINTER key1 key2 key3 = {c}

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

返回值

Multi-bulk reply: 结果集成员的列表.

Redis命令详解-Set


6.sinterstore keystore key1 key2

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

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

返回值

返回整数: 结果集中成员的个数.

Redis命令详解-Set


7.sismember key menber

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

返回值

返回整数,详细说明:

  • 如果member元素是集合key的成员,则返回1
  • 如果member元素不是key的成员,或者集合key不存在,则返回0
Redis命令详解-Set

8.smembers key

返回key集合所有的元素.

该命令的作用与使用一个参数的SINTER命令作用相同.

返回值

Multi-bulk reply:集合中的所有元素.

Redis命令详解-Set


9.smove source destination member

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

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

如果sourcedestination不是集合类型,则返回错误.

返回值

返回整数

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

Redis命令详解-Set


10.srandemember key count

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

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

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

返回值

Bulk reply: 不使用count参数的情况下该命令返回随机的元素,如果key不存在则返回nil.Multi-bulk reply: 使用count参数,则返回一个随机的元素数组,如果key不存在则返回一个空的数组.

Redis命令详解-Set

11.spop key

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

该命令与SRANDMEMBER相似,不同的是srandmember命令返回一个随机元素但是不移除.

返回值

Bulk reply:被移除的元素, 当key不存在的时候返回nil.


Redis命令详解-Set


12.srem key member member

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

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

返回值

返回整数:从集合中移除元素的个数,不包括不存在的成员.

历史

  • >= 2.4: 接受多个member元素参数. Redis 2.4 之前的版本每次只能移除一个元素.
Redis命令详解-Set


13.sunion key key```

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

例如:

key1 = {a,b,c,d}
key2 = {c}
key3 = {a,c,e}
SUNION key1 key2 key3 = {a,b,c,d,e}

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

返回值

Multi-bulk reply:并集的成员列表

Redis命令详解-Set


14.sunionstore leystore key1 key2 `````

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

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

返回值

整数返回:结果集中元素的个数.

Redis命令详解-Set


注:本文的命令详解主要来源redis中文官网,这里是进一步整理供学习和以后查询使用。