JSON.ARRTRIM - 亚马逊 ElastiCache

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

JSON.ARRTRIM

修剪路径处的数组,以便其成为子数组 [start、end](两者均包括在内)。

  • 如果该数组为空,则不执行任何操作,返回 0。

  • 如果 start <0,则将其视为 0。

  • 如果 end >= size(数组的大小),则将其视为 size-1。

  • 如果 start >= size 或 start > end,则清空数组并返回 0。

语法

JSON.ARRINSERT <key> <path> <start> <end>
  • 密钥(必填)— JSON 文档类型的 Valkey 或 Redis OSS 密钥。

  • 路径(必填)-JSON 路径。

  • start(必需)– 起始索引(含)。

  • end(必需)– 结束索引(含)。

Return

如果路径是增强的语法:

  • 表示每个路径处数组的新长度的整数数组。

  • 如果值为空数组,则其对应的返回值为 Null。

  • 如果值不是数组,则其对应的返回值为 Null。

  • 如果有索引参数超出界限,则为 OUTOFBOUNDARIES 错误。

如果路径是受限的语法:

  • 整数,该数组的新长度。

  • 如果数组为空,则为 Null。

  • 如果路径中的值不是数组,则为 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\"]"