ARSCAN

迭代范围内的现有元素，返回索引值对。

语法

ARSCAN key start end [LIMIT limit]

引入版本：8.8.0

复杂度摘要：O(P)

迭代范围内的现有元素，返回索引值对。

必需参数

key

保存数组的键的名称。

start

开始扫描的从零开始的整数索引。如果 start 大于 end，则按相反索引顺序返回元素。

end

停止扫描的从零开始的整数索引（含）。

可选参数

LIMIT

要返回的索引值对的最大数量。省略时，将返回范围内的所有元素。与 ARGETRANGE 不同，空槽不包含在输出中，因此 LIMIT 限制了返回的现有元素的数量。

示例

redis> ARSET myarray 0 "a"
(integer) 1
redis> ARSET myarray 5 "b"
(integer) 1
redis> ARSET myarray 9 "c"
(integer) 1
redis> ARSCAN myarray 0 10
1) 1) (integer) 0
   2) "a"
2) 1) (integer) 5
   2) "b"
3) 1) (integer) 9
   2) "c"
redis> ARSCAN myarray 0 10 LIMIT 2
1) 1) (integer) 0
   2) "a"
2) 1) (integer) 5
   2) "b"

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
✅ 标准 ❌主动-主动	❌ 标准 ❌主动-主动

返回值

RESP2

数组回复：索引值对数组，每个索引值对都是一个二元素数组：[[idx1, val1], [idx2, val2], ...]

RESP3

数组回复：索引值对数组，每个索引值对都是一个二元素数组：[[idx1, val1], [idx2, val2], ...]

资料来源：Redis 官方 ARSCAN 文档；中文内容参考 Redis 文档许可。