JSON.ARRLEN - Amazon ElastiCache

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

JSON.ARRLEN

取得路徑上陣列值的長度。

語法

JSON.ARRLEN <key> [path]

  • key （必要） – JSON 文件類型的 Valkey 或 Redis OSS 金鑰。

  • path (選用) – JSON 路徑。如果未提供，則預設為根。

傳回

如果路徑是增強型語法：

  • 整數陣列代表每個路徑的陣列長度。

  • 如果值不是陣列，其相應的傳回值為 null。

  • 如果沒有文件索引鍵，則為 null。

如果路徑是受限語法：

  • 整數，陣列長度。

  • 如果選取多個物件，命令會傳回第一個陣列的長度。

  • 如果路徑上的值不是陣列，會發生 WRONGTYPE 錯誤。

  • 如果沒有路徑，會發生 NONEXISTENT JSON 錯誤。

  • 如果沒有文件索引鍵，則為 null。

範例

增強型路徑語法：

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)

受限路徑語法：

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 [1] 
(integer) 1 
127.0.0.1:6379> JSON.ARRLEN k1 [2] 
(integer) 2

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] 
(error) WRONGTYPE JSON element is not an array 
127.0.0.1:6379> JSON.ARRLEN k2 [0] 
(integer) 0
127.0.0.1:6379> JSON.ARRLEN k2 [6] 
(error) OUTOFBOUNDARIES Array index is out of bounds
127.0.0.1:6379> JSON.ARRLEN k2 a.b 
(error) NONEXISTENT JSON path does not exist