本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
JSON.ARRPOP
从数组中删除并返回索引处的元素。弹出一个空数组返回 null。
语法
JSON.ARRPOP <key> [path [index]]
密钥(必需)— JSON 文档类型的 Redis 密钥
路径(可选)— 一个 JSON 路径。如果未提供,则默认为 root
index(可选)— 数组中要开始弹出的位置。
如果未提供,则默认为 -1,这意味着最后一个元素。
负值表示距离最后一个元素的位置。
越界索引四舍五入到其各自的数组边界。
返回值
如果路径是增强的语法:
批量字符串数组,表示每个路径处的弹出值。
-
如果值为空数组,则其对应的返回值为 null。
-
如果值不是数组,则其对应的返回值为 null。
如果路径是受限语法:
批量字符串,表示弹出的 JSON 值
如果数组为空,则为空。
-
WRONGTYPE如果路径中的值不是数组,则为错误。
示例
增强路径语法:
127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]' OK 127.0.0.1:6379> JSON.ARRPOP k1 $[*] 1) (nil) 2) "\"a\"" 3) "\"b\"" 127.0.0.1:6379> JSON.GET k1 "[[],[],[\"a\"]]"
受限语法:
127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]' OK 127.0.0.1:6379> JSON.ARRPOP k1 "[\"a\",\"b\"]" 127.0.0.1:6379> JSON.GET k1 "[[],[\"a\"]]" 127.0.0.1:6379> JSON.SET k2 . '[[], ["a"], ["a", "b"]]' OK 127.0.0.1:6379> JSON.ARRPOP k2 . 0 "[]" 127.0.0.1:6379> JSON.GET k2 "[[\"a\"],[\"a\",\"b\"]]"