Set类型介绍
Set是string类型元素的集合。集合成员是唯一的,不能出现重复的数据;集合是通过哈希表实现的,最大的成员数达到2^32-1个
Set原生命令
命令 |
命令描述 |
实例 |
SADD key member1 [member2] |
向集合key添加一个或多个成员,已经存在的成员将被忽略;如果key不存在,则会创建集合key然后执行插入操作;key不是集合Set类型,则返回一个错误,成功则返回被添加到集合中的新元素的数量,被忽略的成员不算 |
SADD set1 'zhu','yu',返回:2 |
SPOP key [count] |
移除集合key中的一个或多个随机成员,并返回被移除的成员;集合不存在或者为空的时候返回nil;count参数只有在3.2+版本以上才能使用 |
SPOP set1,返回:'yu' |
SCARD key |
返回集合中成员的个数,key不存在时返回0 |
SCARD set1, 返回:4 |
SMEMBERS key |
返回集合中所有的成员。不存在的集合被视为空集合 |
SMEMBERS set1;返回:"lin" "qing" "yu" "shan" |
SMOVE source destination member |
将指定成员member从source集合移动到destination集合中,SMOVE是原子操作,要么移动成功,要么移动失败;如果source集合不存在或者source集合中不存在member成员,则SMOVE不做任何操作,返回0;否则将member成员从source移除,添加到destination中去,并返回1;如果destination中存在member,SMOVE则将source中的member删除掉;如果source或destination不是集合,则返回一个错误。如果destination不存在,则创建一个destination并写入member值 |
SMOVE set1 set2 'qing';则set2中存在值‘qing’,而set1中被删除 |
SREM key member1 [member2] |
移除集合key中一个或者多个成员元素,如果member不存在,则忽略此成员元素;如果key不是集合类型,则返回一个错误;成功则返回被移除元素的个数,不包括被忽略的成员元素 |
SREM set2 'qing';返回:1 |
SRANDMEMBER key [count] |
返回集合key中的一个或者count个成员元素,但是不删除key中相应的成员元素;如果count大于0且小于集合的大小,则返回count个成员元素组成的数组;如果count大于0且大于集合的大小,则返回整个集合;如果count小于0,则返回一个具有重复值的数组,长度为count的绝对值;count参数存在,如果集合为空,则返回一个空数组;count参数不存在,如果集合为空则返回nil。 |
SRANDMEMBER set1 2;返回:‘yu’ ‘lin’ |
SISMEMBER key member |
判断成员元素member是否存在于集合key中,若存在则返回1,不存在或者key不存在返回0; |
SISMEMBER set1 'yu',返回1 |
SDIFF key1 [key2] |
返回给定所有集合的差集,不存在的key视为空集。差集的结果来自于first_key,而不是其他的key,也不是所有的key的差集;返回值的类型是列表 |
set1('yu' 'lin' 'shan'),set2('lin','ops'),SDIFF set1 set2,返回‘yu’ ‘shan’ |
SDIFFSTORE destination key1 [key2] |
返回所有集合的差集并存到集合destination中,如果destination已经存在,则会被覆盖 |
SDIFFSTORE set3 set1 set2,则set3的成员包括‘yu’ ‘shan’ |
SINTER key1 [key2] |
返回给定的所有集合的交集。不存在的集合视为空集,当给定集合中存在空集则结果集也为空集;成功则返回交集成员列表 |
SINTER set1 set2,返回:‘lin’ |
SINTERSTORE destination key1 [key2] |
返回给定集合的交集并存储到集合destination中,如果destination已经存在则将其覆盖;成功则返回交集的个数 |
SINTERSTORE set3 set1 set2;返回:1 |
SUNION key1 [key2] |
返回所有给定集合的并集,不存在的集合视为空集 |
SUNION set1 set2,返回:"lin" "ops" "yu" "shan" |
SUNIONSTORE destination key1 [key2] |
将给定集合的并集写入到指定的集合destination中,如果destination已经存在,则将其覆盖;成功则返回并集的个数 |
SUNIONSTORE set3 set1 set2,返回:4 |
SSCAN key cursor [MATCH pattern] [COUNT count] |
用于迭代集合中键的元素,返回数组列表 |
SSCAN set1 0 match *n,返回数组0=>['lin' 'shan'] |
php操作redis Set的函数
-
sAdd(key,value1,value2 .....)函数
* 说明:将一个或多个value成员加入到集合key中,若key不存在,则新建集合key;
* 参数:key(集合名称),value(将要插入集合key的成员)
* 返回值:成功则返回插入到key中的成员个数,失败则返回false
* php $ret = $redis->sAdd($key1,'zhu','yu'); var_dump($ret); /* 2 */
-
sPop(key,[count])函数
* 说明:随机弹出集合key中的一个或者count个成员
* 参数:key(集合名称),count(可选项,要弹出成员的个数)
* 返回:count不存在,随机返回key中的一个成员;count存在,返回一个包含多个key成员的数组,count>key的长度,则返回整个集合组成的数组;若key不是Set类型,则返回false
* 注意: redis的版本>=3.2才能使用count参数
* php $redis->sAdd($key1,'lin','qing'); $ret = $redis->sPop($key1); var_dump($ret); /* ‘zhu’ */
-
sCard(key), sSize(key)函数
* 说明:获取集合key中成员的个数,两个函数作用是相同的
* 参数:key(集合名称)
* 返回:成功则返回集合的长度,集合不存在则返回false
* php $ret = $redis->sCard($key1); var_dump($ret); /* 4 */
-
sMembers(key), sGetMembers(key)函数
* 说明:获取集合key中所有的成员,两个函数作用是相同的
* 参数:key(集合名称)
* 返回:成功则返回包含key所有成员的数组,数组是随机的,集合key为空,则返回一个空数组
* php $ret = $redis->sMembers($key1); var_dump($ret); /* array(4) { [0]=> string(4) "qing" [1]=> string(3) "lin" [2]=> string(2) "yu" [3]=> string(3) "zhu" } */ $res = $redis->sMembers($key2); var_dump($res); /* array(0) { } */
-
sMove(srcKey,dstKey,member)函数
* 说明:从srcKey中移除member,然后写入到dstKey中,此操作是原子操作,要么成功,要么失败;
* 参数:srcKey,dstKey(集合名称),member(将要操作的成员)
* 返回:执行成功返回true,失败则返回false(srcKey,dstKey,member不存在)
* php $ret = $redis->sMove($key1,$key2,'yu'); var_dump($ret); /* bool(true) */ $redis->sMembers($key2); /* ‘yu’ */
-
sRem(key,member1,[member2],...), sRemove(key,member,[member2],...)函数
* 说明:移除集合key中的成员member,两个函数作用是相同的
* 参数: key(集合的名称),member(集合key中的成员)
* 返回:返回从key中移除的成员的个数
* php $ret = $redis->sRem($key1,'lin'); var_dump($ret); /* int(1) */
-
sRandMember(key,[count])函数
* 说明:从集合key中随机取出一个或count个成员,但是不移除key中的成员
* 参数:key(集合的名称),count(可选项,随机取出成员的个数)
* 返回值:没有count参数,返回key中的一个成员(string);存在count,则返回随机取出的成员组成的数组(array):count>0且大于或等于集合key的大小,则返回整个集合;count>0且小于key的大小,则返回key中的count个成员,且不重复;count<0且绝对值小于key的大小,则返回|count|个不含重复值的数组;count<0且绝对值大于key的大小,则返回|count|个含有重复值的数组;key为空集,则返回一个空数组;key不是集合类型,则返回false;
* php $redis->sRandMember($key1,2); /* array(2) { [0]=> string(4) "qing" [1]=> string(3) "zhu" } */ $redis->sRandMember($key1,-3); /* array(3) { [0]=> string(4) "qing" [1]=> string(3) "zhu" [2]=> string(4) "qing" } */ $redis->sRandMember($key4,-3); /* array(0) { } */ $redis->sRandMember('string1',6); /* bool(false) */
-
sIsMember(key,member),sContains(key,member)函数
* 说明: 判断member是否存在于集合key中,两个函数的作用是一样的
* 参数: key(集合的名称),member(需要判断的值)
* 返回:如果member存在于集合key中,则返回true,否则返回false
* php $redis->sIsMember($key1,'qing'); /* true */
-
sDiff(key1,key2,.....keyN)函数
* 说明:获取多个key之间的差集并返回
* 参数:keyN(集合的名称)
* 返回:与key1相比较得到的差集所组成的数组
* php $redis->sDiff($key1,$key2); /* array(2) { [0]=> string(4) "qing" [1]=> string(3) "zhu" } */
-
sDiffStore(dstKey,key1,key2, ..... keyN)函数
* 说明:获取多个给定的集合key之间的差集并存储到集合dstKey中;如果dstKey已经存在则将其覆盖
* 参数:dstKey(获取差集之后要存储的集合),keyN(给定的集合key)
* 返回:执行成功则返回差集的个数;失败则返回false
* php $redis->sDiffStore($key3,$key1,$key2); /* 2 */
-
sInter(key1,key2,.....keyN)函数
* 说明:返回所有给定的集合key的交集所组成的数组
* 参数:keyN(集合名称)
* 返回:返回所有给定的集合key的交集所组成的数组,如果给定的集合中存在空集,则返回一个空数组
* php $redis->sInter($key1,$key2); /* array(0) { } */
-
sInterStore(dstKey,key1,...,keyN)函数
* 说明:获取所有给定的集合key的交集并存入集合dstKey中;如果dstKey已经存在,则将其覆盖。
* 参数:dstKey(目标集合的名称),keyN(给定的集合key)
* 返回:获取所有给定的集合key的交集并存入集合dstKey中,成功则将交集写入到dstKey中并返回交集的个数,失败则返回false;
* php $redis->sInterStore($key3,$key1,$key2);/* int(0) */
-
sUnion(key1,...,keyN)函数
* 说明:返回给定的多个key的交集
* 参数:keyN(集合名称)
* 返回:成功则返回所有集合的交集所组成的索引数组,失败则返回false
* php $redis->sUnion($key1,$key2);/* array(3) { [0]=> string(4) "qing" [1]=> string(2) "yu" [2]=> string(3) "zhu" } */
-
sUnionStore(dstkey,key1,....,keyN)函数
* 说明: 将给定集合的并集写入到指定的集合dstKey中;如果dstKey已经存在,则将其覆盖。
* 参数:dstkey(指定的集合),keyN(给定的集合)
* 返回:成功则返回dstKey中集合的个数,失败则返回false
* php $redis->sUnionStore($key3,$key1,$key2); /* int(3) */
-
sScan(key,iterator,pattern,count)函数
* 说明:扫描(遍历)一遍集合的成员
* 参数:key(集合的名称),iterator(迭代器),pattern(遍历时的匹配条件),count(期望返回成员的数量)
* 返回:执行成功返回一个数组,失败则返回false
|
请发表评论