本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
JSON.ARRTRIM
在路径处修剪数组,使其成为子数组 [start, end],两者都包括在内。
如果数组为空,则无效,返回 0。
如果 start <0,则将其视为 0。
如果 end >= 大小(数组的大小),则将其视为 size-1。
如果 start >= size 或 start > end,则清空数组并返回 0。
语法
JSON.ARRINSERT <key> <path> <start> <end>
密钥(必需)— JSON 文档类型的 Redis 密钥
路径(必需)— 一个 JSON 路径
start(必需)— 起始索引(含)。
end(必需)— 结束索引,包含。
返回值
如果路径是增强的语法:
整数数组,表示每条路径处数组的新长度。
-
如果值为空数组,则其对应的返回值为 null。
-
如果值不是数组,则其对应的返回值为 null。
-
OUTOFBOUNDARIES如果索引参数超出了界限,则错误。
如果路径是受限语法:
整数,数组的新长度。
如果数组为空,则为空。
-
WRONGTYPE如果路径中的值不是数组,则为错误。 -
OUTOFBOUNDARIES如果索引参数超出了界限,则错误。
示例
增强语法:
127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"], ["a", "b", "c"]]' OK 127.0.0.1:6379> JSON.ARRTRIM k1 $[*] 0 1 1) (integer) 0 2) (integer) 1 3) (integer) 2 4) (integer) 2 127.0.0.1:6379> JSON.GET k1 "[[],[\"a\"],[\"a\",\"b\"],[\"a\",\"b\"]]"
受限语法:
127.0.0.1:6379> JSON.SET k1 . '{"children": ["John", "Jack", "Tom", "Bob", "Mike"]}' OK 127.0.0.1:6379> JSON.ARRTRIM k1 .children 0 1 (integer) 2 127.0.0.1:6379> JSON.GET k1 .children "[\"John\",\"Jack\"]"