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