本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
JSON.ARRPOP
從數組中刪除並返回索引處的元素。彈出空陣列會傳回 null。
語法
JSON.ARRPOP <key> [path [index]]
密鑰(必填)-JSON 文檔類型的紅色 OSS 密鑰
路徑 (選用) — JSON 路徑。如果未提供,則默認為根
index(可選)-數組中的位置開始彈出。
如果未提供,預設為 -1,表示最後一個元素。
負值表示從最後一個元素數起的位置。
超出範圍的索引會四捨五入到各自的陣列範圍。
傳回
如果路徑是增強型語法:
批量字符串數組,代表每個路徑上的彈出值。
-
如果值是空陣列,其相應的傳回值為 null。
-
如果值不是陣列,其相應的傳回值為 null。
如果路徑是受限語法:
批量字符串,代表彈出的 JSON 值
如果陣列是空的,則為 null。
-
如果路徑上的值不是陣列,會發生
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\"]]"