Redis五大数据类型之Set(集合)操作命令

Redis五大数据类型之Set操作命令

• 一、常用命令
• • 1.1 SADD key member [member …]
  • 1.2 SISMEMBER key member
  • 1.3 SPOP key
  • 1.4 SRANDMEMBER key [count]
  • 1.5 SREM key member [member …]
  • 1.6 SMOVE source destination member
  • 1.7 SCARD key
  • 1.8 SMEMBERS key
  • 1.9 SSCAN key cursor [MATCH pattern] [COUNT count]
  • 1.10 SINTER key [key …]
  • 1.11 SINTERSTORE destination key [key …]
  • 1.12 SUNION key [key …]
  • 1.13 SUNIONSTORE destination key [key …]
  • 1.14 SDIFF key [key …]
  • 1.15 SDIFFSTORE destination key [key …]

一、常用命令

1.1 SADD key member [member …]

将一个或多个 member 元素加入到集合 key 当中，已经存在于集合的 member 元素将被忽略。

假如 key 不存在，则创建一个只包含 member 元素作成员的集合。 当 key 不是集合类型时，返回一个错误。

1.2 SISMEMBER key member

判断 member 元素是否集合 key 的成员。
返回值：如果 member 元素是集合的成员，返回 1 。 如果 member 元素不是集合的成员，或 key 不存在，返回 0 。

1.3 SPOP key

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

如果只想获取一个随机元素，但不想该元素从集合中被移除的话，可以使用 SRANDMEMBER key [count] 命令。

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

1.4 SRANDMEMBER key [count]

如果命令执行时，只提供了 key 参数，那么返回集合中的一个随机元素。

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

如果 count 为正数，且小于集合基数，那么命令返回一个包含 count 个元素的数组，数组中的元素各不相同。如果 count大于等于集合基数，那么返回整个集合。
如果 count 为负数，那么命令返回一个数组，数组中的元素可能会重复出现多次，而数组的长度为 count 的绝对值。
该操作和 SPOP key 相似，但 SPOP key 将随机元素从集合中移除并返回，而 SRANDMEMBER
则仅仅返回随机元素，而不对集合进行任何改动。

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

1.5 SREM key member [member …]

移除集合 key 中的一个或多个 member 元素，不存在的 member 元素会被忽略。
当 key 不是集合类型，返回一个错误。
返回值：被成功移除的元素的数量，不包括被忽略的元素。

1.6 SMOVE source destination member

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

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

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

1.7 SCARD key

返回集合 key 的基数(集合中元素的数量)。
返回值：集合的基数。 当 key 不存在时，返回 0 。

1.8 SMEMBERS key

返回集合 key 中的所有成员。
不存在的 key 被视为空集合。
返回值：集合中的所有成员

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

迭代集合中的元素

1.10 SINTER key [key …]

返回一个集合的全部成员，该集合是所有给定集合的交集。
不存在的 key 被视为空集。
当给定集合当中有一个空集时，结果也为空集(根据集合运算定律)。
返回值：交集成员的列表

1.11 SINTERSTORE destination key [key …]

这个命令类似于 SINTER key [key …] 命令，但它将结果保存到 destination 集合，而不是简单地返回结果集。
如果 destination 集合已经存在，则将其覆盖。
destination 可以是 key 本身。
返回值：结果集中的成员数量

1.12 SUNION key [key …]

返回一个集合的全部成员，该集合是所有给定集合的并集。
不存在的 key 被视为空集。
返回值：并集成员的列表

1.13 SUNIONSTORE destination key [key …]

这个命令类似于 SUNION key [key …] 命令，但它将结果保存到 destination 集合，而不是简单地返回结果集。
如果 destination 已经存在，则将其覆盖。
destination 可以是 key 本身。
返回值：结果集中的元素数量

1.14 SDIFF key [key …]

返回一个集合的全部成员，该集合是所有给定集合之间的差集。
不存在的 key 被视为空集。
返回值：一个包含差集成员的列表

1.15 SDIFFSTORE destination key [key …]

这个命令的作用和 SDIFF key [key …] 类似，但它将结果保存到 destination 集合，而不是简单地返回结果集。
如果 destination 集合已经存在，则将其覆盖。
destination 可以是 key 本身。
返回值：结果集中的元素数量