JSON.ARRLEN - 亚马逊 ElastiCache

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

JSON.ARRLEN

获取路径中数组值的长度。

语法

JSON.ARRLEN <key> [path]
  • 密钥(必填)— JSON 文档类型的 Valkey 或 Redis OSS 密钥。

  • 路径(可选)-JSON 路径。如果未提供,则默认为根目录。

Return

如果路径是增强的语法:

  • 表示每个路径处数组长度的整数数组。

  • 如果值不是数组,则其对应的返回值为 Null。

  • 如果文档键不存在,则为 Null。

如果路径是受限的语法:

  • 批量字符串数组。每个元素都是对象中的键名称。

  • 整数,数组长度。

  • 如果选择了多个对象,该命令将返回第一个数组的长度。

  • 如果路径中的值不是数组,则为 WRONGTYPE 错误。

  • 如果路径不存在,则为 WRONGTYPE 错误。

  • 如果文档键不存在,则为 Null。

示例

增强的路径语法:

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)

受限的路径语法:

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