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

# JSON.ARRTRIM
<a name="json-arrtrim"></a>

修剪路径处的数组，以便其成为子数组 [start、end]（两者均包括在内）。
+ 如果该数组为空，则不执行任何操作，返回 0。
+ 如果 start <0，则将其视为 0。
+ 如果 end >= size（数组的大小），则将其视为 size-1。
+ 如果 start >= size 或 start > end，则清空数组并返回 0。

语法

```
JSON.ARRTRIM <key> <path> <start> <end>
```
+ key（必需）– JSON 文档类型的 Valkey 或 Redis OSS 键。
+ path（必需）– 一个 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\"]"
```