JSON.ARRPOP - Amazon ElastiCache

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

JSON.ARRPOP

移除並傳回陣列索引的元素。彈出空陣列會傳回 null。

語法

JSON.ARRPOP <key> [path [index]]

  • 金鑰 （必要） – JSON 文件類型的 Valkey 或 Redis 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\"]]"