JSON.ARRPOP - Amazon ElastiCache (RedisOSS)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

JSON.ARRPOP

Supprime et renvoie l'élément à l'index du tableau. L'extraction d'un tableau vide renvoie valeur nulle.

Syntaxe

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

  • clé (obligatoire) — Une clé Redis OSS de type document JSON.

  • path (facultatif) : chemin JSON. Par défaut, il s'agit de la racine si elle n'est pas fournie.

  • index (facultatif) : La pposition dans le tableau à partir de laquelle l'extraction doit commencer.

    • La valeur par défaut est -1 si elle n'est pas fournie, ce qui signifie le dernier élément.

    • Une valeur négative signifie une position à partir du dernier élément.

    • Les index hors limites sont arrondis à leurs limites de tableau respectives.

Retour

Si le chemin est une syntaxe améliorée :

  • Tableau de chaînes en bloc qui représentent les valeurs extraites au niveau de chaque chemin.

  • Si une valeur est un tableau vide, sa valeur de retour correspondante est nulle.

  • Si une valeur n'est pas un tableau, sa valeur de retour correspondante est nulle.

Si le chemin est une syntaxe restreinte :

  • Chaîne en bloc, qui représente la valeur JSON extraite.

  • Valeur nulle si le tableau est vide.

  • Erreur WRONGTYPE si la valeur au niveau du chemin n'est pas un tableau.

Exemples

Syntaxe de chemin améliorée :

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

Syntaxe de chemin restreinte :

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