

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

# JSON.ARRAPPEND
<a name="json-arrappend"></a>

将一个或多个值附加到路径上的数组值。

语法

```
JSON.ARRAPPEND <key> <path> <json> [json ...]
```
+ key（必需）– JSON 文档类型的键
+ path（必需）– 一个 JSON 路径
+ json（必需）– 要附加到数组的 JSON 值

**Return**

如果路径是增强的语法：
+ 表示每个路径处数组的新长度的整数数组。
+ 如果值不是数组，则其对应的返回值为 Null。
+ 如果输入 json 参数之一不是有效的 JSON 字符串，则为 `SYNTAXERR` 错误。
+ 如果路径不存在，则为 `NONEXISTENT` 错误。

如果路径是受限的语法：
+ 整数，该数组的新长度。
+ 如果选择了多个数组值，该命令将返回上次更新数组的新长度。
+ 如果路径中的值不是数组，则为 `WRONGTYPE` 错误。
+ 如果输入 json 参数之一不是有效的 JSON 字符串，则为 `SYNTAXERR` 错误。
+ 如果路径不存在，则为 `NONEXISTENT` 错误。

**示例**

 增强的路径语法：

```
127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]'
OK
127.0.0.1:6379> JSON.ARRAPPEND  k1 $[*] '"c"'
1) (integer) 1
2) (integer) 2
3) (integer) 3
127.0.0.1:6379> JSON.GET k1
"[[\"c\"],[\"a\",\"c\"],[\"a\",\"b\",\"c\"]]"
```

 受限的路径语法：

```
127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]'
OK
127.0.0.1:6379> JSON.ARRAPPEND  k1 [-1] '"c"'
(integer) 3
127.0.0.1:6379> JSON.GET k1
"[[],[\"a\"],[\"a\",\"b\",\"c\"]]"
```