JSON.ARRLEN - Amazon ElastiCache

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.ARRLEN

Obtient la longueur des valeurs du tableau au niveau du chemin.

Syntaxe

JSON.ARRLEN <key> [path]
  • clé (obligatoire) — Une clé Valkey ou Redis de OSS type JSON document.

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

Retour

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

  • Tableau d'entiers qui représentent la longueur du tableau au niveau de chaque chemin.

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

  • Valeur nulle si la clé du document n'existe pas.

Si le chemin est une syntaxe restreinte :

  • Tableau de chaînes en bloc. Chaque élément est un nom de clé dans l'objet.

  • Entier, longueur du tableau.

  • Si plusieurs objets sont sélectionnés, la commande renvoie la longueur du premier tableau.

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

  • Erreur WRONGTYPE si le chemin n'existe pas.

  • Valeur nulle si la clé du document n'existe pas.

Exemples

Syntaxe de chemin améliorée :

127.0.0.1:6379> JSON.SET k1 . '[[], [\"a\"], [\"a\", \"b\"], [\"a\", \"b\", \"c\"]]' (error) SYNTAXERR Failed to parse JSON string due to syntax error 127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"], ["a", "b", "c"]]' OK 127.0.0.1:6379> JSON.ARRLEN k1 $[*] 1) (integer) 0 2) (integer) 1 3) (integer) 2 4) (integer) 3 127.0.0.1:6379> JSON.SET k2 . '[[], "a", ["a", "b"], ["a", "b", "c"], 4]' OK 127.0.0.1:6379> JSON.ARRLEN k2 $[*] 1) (integer) 0 2) (nil) 3) (integer) 2 4) (integer) 3 5) (nil)

Syntaxe de chemin restreinte :

127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"], ["a", "b", "c"]]' OK 127.0.0.1:6379> JSON.ARRLEN k1 [*] (integer) 0 127.0.0.1:6379> JSON.ARRLEN k1 $[3] 1) (integer) 3 127.0.0.1:6379> JSON.SET k2 . '[[], "a", ["a", "b"], ["a", "b", "c"], 4]' OK 127.0.0.1:6379> JSON.ARRLEN k2 [*] (integer) 0 127.0.0.1:6379> JSON.ARRLEN k2 $[1] 1) (nil) 127.0.0.1:6379> JSON.ARRLEN k2 $[2] 1) (integer) 2