

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

# JSON.STRAPPEND
<a name="json-strappend"></a>

将字符串附加到路径的 JSON 字符串。

语法

```
JSON.STRAPPEND <key> [path] <json_string>
```
+ key（必需）– JSON 文档类型的键
+ path（可选）– 一个 JSON 路径。如果未提供，则默认为根目录
+ json\$1string（必需）– 字符串的 JSON 表示。请注意，JSON 字符串必须用引号括起来，即'"foo"'。

**Return**

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

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

**示例**

 增强的路径语法：

```
127.0.0.1:6379> JSON.SET k1 $ '{"a":{"a":"a"}, "b":{"a":"a", "b":1}, "c":{"a":"a", "b":"bb"}, "d":{"a":1, "b":"b", "c":3}}'
OK
127.0.0.1:6379> JSON.STRAPPEND k1 $.a.a '"a"'
1) (integer) 2
127.0.0.1:6379> JSON.STRAPPEND k1 $.a.* '"a"'
1) (integer) 3
127.0.0.1:6379> JSON.STRAPPEND k1 $.b.* '"a"'
1) (integer) 2
2) (nil)
127.0.0.1:6379> JSON.STRAPPEND k1 $.c.* '"a"'
1) (integer) 2
2) (integer) 3
127.0.0.1:6379> JSON.STRAPPEND k1 $.c.b '"a"'
1) (integer) 4
127.0.0.1:6379> JSON.STRAPPEND k1 $.d.* '"a"'
1) (nil)
2) (integer) 2
3) (nil)
```

 受限的路径语法：

```
127.0.0.1:6379> JSON.SET k1 . '{"a":{"a":"a"}, "b":{"a":"a", "b":1}, "c":{"a":"a", "b":"bb"}, "d":{"a":1, "b":"b", "c":3}}'
OK
127.0.0.1:6379> JSON.STRAPPEND k1 .a.a '"a"'
(integer) 2
127.0.0.1:6379> JSON.STRAPPEND k1 .a.* '"a"'
(integer) 3
127.0.0.1:6379> JSON.STRAPPEND k1 .b.* '"a"'
(integer) 2
127.0.0.1:6379> JSON.STRAPPEND k1 .c.* '"a"'
(integer) 3
127.0.0.1:6379> JSON.STRAPPEND k1 .c.b '"a"'
(integer) 4
127.0.0.1:6379> JSON.STRAPPEND k1 .d.* '"a"'
(integer) 2
```