JSON.ARRPOP - Amazon ElastiCache

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

JSON.ARRPOP

Elimina y devuelve elemento en el índice de la matriz. Al emerger una matriz vacía, se devuelve nulo.

Sintaxis

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

  • key (obligatorio): una clave de Valkey o Redis OSS del tipo de documento JSON.

  • ruta (opcional): una ruta JSON. Toma el valor predeterminado raíz si no se proporciona.

  • índice (opcional): la pposición en la matriz desde la que empezar a salir.

    • El valor predeterminado es -1 si no se proporciona, lo que significa el último elemento.

    • Un valor negativo significa la posición desde el último elemento.

    • Los índices fuera de los límites se redondean a sus respectivos límites de matriz.

Devolución

Si la ruta es de sintaxis mejorada:

  • Matriz de cadenas masivas que representan valores emergentes en cada ruta.

  • Si un valor es una matriz vacía, su valor devuelto correspondiente es nulo.

  • Si un valor no es una matriz, su valor devuelto correspondiente es nulo.

Si la ruta es de sintaxis restringida:

  • Cadena por lotes, que representa el valor JSON emergente.

  • Es nulo si la matriz está vacía.

  • Error WRONGTYPE si el valor de la ruta no es una matriz.

Ejemplos

Sintaxis de la ruta mejorada:

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\"]]"

Sintaxis de la ruta restringida:

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\"]]"