JSON.ARRINSERT

将一个或多个值插入到索引之前路径处的数组值中。

语法

JSON.ARRINSERT <key> <path> <index> <json> [json ...]

• 密钥（必填）— JSON 文档类型的 Valkey 或 Redis OSS 密钥。

• 路径（必填）-JSON 路径。

• index（必需）– 在其前面插入值的数组索引。

• json（必填）-要附加到数组的JSON值。

Return

如果路径是增强的语法：

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

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

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

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

如果路径是受限的语法：

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

• 如果路径中的值不是数组，则为 WRONGTYPE 错误。

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

示例

增强的路径语法：

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

受限的路径语法：

127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]'
OK
127.0.0.1:6379> JSON.ARRINSERT k1 . 0 '"c"'
(integer) 4
127.0.0.1:6379> JSON.GET k1
"[\"c\",[],[\"a\"],[\"a\",\"b\"]]"