

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

# JSON.ARRPOP
<a name="json-arrpop"></a>

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

语法

```
JSON.ARRPOP <key> [path [index]]
```
+ key（必需）– JSON 文档类型的键
+ 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\"]]"
```