本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
JSON.ARRINSERT
在索引前的路径处将一个或多个值插入到数组值中。
语法
JSON.ARRINSERT <key> <path> <index> <json> [json ...]
key(必需)— JSON 文档类型的 Redis 键
路径(必填)— 一个 JSON 路径
索引(必填)— 在数组索引之前插入值。
json(必填)— 要附加到数组的 JSON 值
返回值
如果路径是增强的语法:
整数组的新长度,该数组的新长度。
-
如果值为空数组,则其对应的返回值为 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\"]]"