JSON.STRAPPEND

将 json-string 值附加到路径处的字符串

语法

JSON.STRAPPEND key [path] value

引入版本：1.0.0

复杂度摘要：O(1)

将字符串附加到与给定路径表达式匹配的路径处的 JSON 字符串。

示例

必需参数

key

是存储 JSON 类型值的 Redis 键。

value

是附加到与 path 匹配的路径处的 JSON 字符串的字符串。

[!NOTE] 关于在 JSON 命令中使用字符串要将字符串指定为要附加的数组值，请使用一组附加的单引号将带引号的字符串括起来。示例：'"silver"'。更详细的使用请参见示例。

可选参数

path

是

JSONPath 表达式
根“$”，或以“$.”或“$[”开头的任何字符串。
解析为 key 中的所有匹配位置。
遗留路径表达式
任何与上述 JSONPath 语法不匹配的字符串。
允许省略前导“.”（例如，“name”和“.name”是等效的）。
仅解析为 key 中的第一个匹配位置。

默认值：“.”（指向文档根目录的旧路径）。

示例

redis> JSON.SET doc $ '{"a":"foo", "nested": {"a": "hello"}, "nested2": {"a": 31}}' OK redis> JSON.STRAPPEND doc $..a '"baz"' 1) (整数) 6 2) (整数) 8 3) (nil) redis> JSON.GET doc $ "[{\"a\":\"foobaz\",\"nested\":{\"a\":\"hellobaz\"},\"nested2\":{\"a\":31}}]"

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
✅ 支持	✅ 灵活且每年一次 ✅ 免费和固定

返回值

RESP2

如果 path 是 JSONPath 表达式：

如果 key 不存在，则为简单错误。
如果 path 没有匹配项，则为空数组回复。
数组回复，其中每个数组元素对应一个匹配项：
如果匹配不是字符串，则 nil。
整数回复：字符串的新长度。

如果 path 是旧路径表达式：

如果 key 不存在，则为简单错误。
如果 path 没有匹配项，则为简单错误。
如果第一个匹配不是字符串，则为简单错误。
整数回复：第一次匹配时字符串的新长度。

RESP3