Redis SSCAN 命令用于迭代集合键中的元素。

( Redis >= 1.0.0 )

语法

Redis SSCAN 命令语法如下：

SSCAN key cursor [MATCH pattern] [COUNT count]

• cursor 参数。SSCAN 命令每次被调用之后， 都会向用户返回一个新的游标， 用户在下次迭代时需要使用这个新游标作为 SSCAN 命令的游标参数， 以此来延续之前的迭代过程。
  当 SCAN 命令的游标参数被设置为 0 时， 服务器将开始一次新的迭代， 而当服务器向用户返回值为 0 的游标时， 表示迭代已结束

• count 参数。虽然增量式迭代命令不保证每次迭代所返回的元素数量， 但我们可以使用 COUNT 选项， 对命令的行为进行一定程度上的调整。 基本上， COUNT 选项的作用就是让用户告知迭代命令， 在每次迭代中应该从数据集里返回多少元素

• MATCH 参数。 和 KEYS 命令一样， 增量式迭代命令也可以通过提供一个 glob 风格的模式参数， 让命令只返回和给定模式相匹配的元素， 这一点可以通过在执行增量式迭代命令时， 通过给定 MATCH <pattern> 参数来实现

count 参数的默认值为 10

返回值

数组列表

范例

127.0.0.1:6379> FLUSHALL
OK
127.0.0.1:6379> SADD word "hello" "hi" "bar" "bash" "bat" "battle"
(integer) 6
127.0.0.1:6379> sscan word 0 match h* COUNT 3
1) "2"
2) 1) "hello"
   2) "hi"