JSON.ARRPOP - ElastiCache 适用于 Redis 的 Amazon
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

JSON.ARRPOP

从数组中删除并返回索引处的元素。弹出空数组会返回 Null。

语法

JSON.ARRPOP <key> [path [index]]
  • key(必需)– JSON 文档类型的 Redis 键。

  • path(可选)– 一个 JSON 路径。如果未提供,则默认为根目录。

  • index(可选)– 数组中要开始弹出的位置。

    • 如果未提供,则默认为 -1,这表示最后一个元素。

    • 负值表示距离最后一个元素的位置。

    • 超出边界的索引会舍入到其各自的数组边界。

Return

如果路径是增强的语法:

  • 表示每个路径上弹出值的批量字符串数组。

  • 如果值为空数组,则其对应的返回值为 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\"]]"