`
huangz
  • 浏览: 320129 次
  • 性别: Icon_minigender_1
  • 来自: 广东-清远
社区版块
存档分类
最新评论

Redis命令参考(Commands Reference)中文翻译【Set部分】

阅读更多

注意:此文档已经过期,请移步到 http://huangz.iteye.com/blog/1123512 查看最新翻译。

 

SADD key member


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


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

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

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


时间复杂度:

    O(1)

返回值:

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

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


 

redis> SADD bbs "v2ex.com"
(integer) 1
redis> SADD bbs "codecompo.com"
(integer) 1

redis> SMEMBERS bbs     # 显示bbs集合中所有成员
1) "codecompo.com"
2) "v2ex.com"

redis> SADD bbs "v2ex.com"  # 尝试添加重复元素,返回0
(integer) 0

 




SINTER key [key ...]


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


不存在的key被视为空集。

当给定集合当中有一个空集时,结果也为空集(根据集合运算定律)。


时间复杂度:

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

返回值:

    交集成员的列表。


 

redis> SMEMBERS group_1
1) "LI LEI"
2) "TOM"
3) "JACK"   # <-

redis> SMEMBERS group_2
1) "HAN MEIMEI"
2) "JACK"   # <-

redis> SINTER group_1 group_2
1) "JACK"

 

 

 


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> SMEMBERS songs
1) "Billie Jean"
2) "Believe Me"

redis> SMEMBERS my_songs
(empty list or set)

redis> SMOVE songs my_songs "Believe Me"
(integer) 1

redis> SMEMBERS songs
1) "Billie Jean"

redis> SMEMBERS my_songs
1) "Believe Me"

 

 


SUNION key [key ...]

 

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

 

不存在的key被视为空集。

 

复杂度:

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

返回值:

    并集成员的列表。

 

 

redis> SMEMBERS songs
1) "Billie Jean"

redis> SMEMBERS my_songs
1) "Believe Me"

redis> SUNION songs my_songs
1) "Billie Jean"
2) "Believe Me"
 

 


SCARD key

 

返回集合的基数(集合中元素的数量)。

 

复杂度:

    O(1)

返回值:

    集合的基数。

    当key不存在时,返回0。

 

 

redis> SMEMBERS tool
1) "pc"
2) "printer"
3) "phone"

redis> SCARD tool
(integer) 3

redis> SMEMBERS fake_set
(empty list or set)

redis> SCARD fake_set
(integer) 0

 

 


SINTERSTORE destination key [key ...]

 

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

 

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

 

时间复杂度:

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

返回值:

    结果集中的元素数量。

 

 

redis> SMEMBERS songs
1) "good bye joe"   # <-
2) "hello,peter"

redis> SMEMBERS my_songs
1) "good bye joe"   # <-
2) "falling"

redis> SINTERSTORE song_and_my_song songs my_songs
(integer) 1

redis> SMEMBERS song_and_my_song
1) "good bye joe"

 

 


SPOP key

 

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

 

复杂度:

    O(1)

返回值:

    被移除的随机元素。

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

 

 

redis> SMEMBERS my_sites
1) "huangz.iteye.com"
2) "sideeffect.me"
3) "douban.com/people/i_m_huangz"

redis> SPOP my_sites
"huangz.iteye.com"

redis> SMEMBERS my_sites
1) "sideeffect.me"
2) "douban.com/people/i_m_huang"

 

 


SUNIONSTORE destination key [key ...]

 

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

 

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

 

复杂度:

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

返回值:

    结果集中的元素数量。

 

 

redis> SMEMBERS ms_sites
1) "microsoft.com"
2) "skype.com"

redis> SMEMBERS google_sites
1) "youtube.com"
2) "google.com"

redis> SUNIONSTORE google_and_ms_sites ms_sites google_sites
(integer) 4

redis> SMEMBERS google_and_ms_sites
1) "microsoft.com"
2) "skype.com"
3) "google.com"
4) "youtube.com"
 

 


SDIFF key [key ...]

 

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

 

不存在的key被视为空集。

 

复杂度:

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

返回值:

    交集成员的列表。

 

 

redis> SMEMBERS peter's_movies
1) "bet man"
2) "start war"
3) "2012"   # <-

redis> SMEMBERS joe's_movies
1) "hi, lady"
2) "Fast Five"
3) "2012"   # <-

redis> SDIFF peter's_movies joe's_movies
1) "bet man"
2) "start war"

 

 


SISMEMBER key member

 

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

 

时间复杂度:

    O(1)

返回值:

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

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

 

 

redis> SMEMBERS joe's_movies
1) "hi, lady"
2) "Fast Five"
3) "2012"

redis> SISMEMBER joe's_movies "bet man"
(integer) 0

redis> SISMEMBER joe's_movies "Fast Five"
(integer) 1

 

 


SRANDMEMBER key

 

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

 

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

 

时间复杂度:

    O(1)

返回值:

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

 

 

redis> SMEMBERS joe's_movies
1) "hi, lady"
2) "Fast Five"
3) "2012"

redis> SRANDMEMBER joe's_movies
"Fast Five"

redis> SMEMBERS joe's_movies    # 集合中的元素不变
1) "hi, lady"
2) "Fast Five"
3) "2012"
 

 


SDIFFSTORE destination key [key ...]

 

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

 

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

 

复杂度:

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

返回值:

    结果集中的元素数量。

 

 

redis> SMEMBERS joe's_movies
1) "hi, lady"
2) "Fast Five"
3) "2012"

redis> SMEMBERS peter's_movies
1) "bet man"
2) "start war"
3) "2012"

redis> SDIFFSTORE joe_diff_peter joe's_movies peter's_movies
(integer) 2

redis> SMEMBERS joe_diff_peter
1) "hi, lady"
2) "Fast Five"

 

 

 

SMEMBERS key

 

返回集合中的所有成员。

 

时间复杂度:

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

返回值:

    集合中的所有成员。

 

 

redis> SMEMBERS prog_lang
1) "c"
2) "ruby"
3) "python"

 

 


SREM key member

 

移除集合中的member元素。

 

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

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

时间复杂度:

    O(1)

返回值:

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

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

 

 

redis> SMEMBERS prog_lang
1) "c"
2) "ruby"
3) "python"

redis> SREM prog_lang "c"
(integer) 1

redis> SMEMBERS prog_lang
1) "ruby"
2) "python"

redis> SREM prog_lang "scheme"
(integer) 0

redis> SMEMBERS prog_lang
1) "ruby"
2) "python"
 

 

 

 

 

分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics