

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# JSON.ARRLEN
<a name="json-arrlen"></a>

Obtém o comprimento dos valores da matriz no caminho.

Sintaxe

```
JSON.ARRLEN <key> [path] 
```
+ chave (obrigatório): uma chave do Valkey ou Redis OSS do tipo de documento JSON.
+ path (opcional): um caminho JSON. Assumirá o padrão da raiz se não for fornecido.

**Return**

Se o caminho for uma sintaxe aprimorada:
+ Matriz de inteiros que representam o comprimento da matriz em cada caminho.
+ Se um valor não for uma matriz, seu valor de retorno correspondente será nulo.
+ Nulo se a chave do documento não existir.

Se o caminho for uma sintaxe restrita:
+ Inteiro, comprimento da matriz.
+ Se vários objetos forem selecionados, o comando retornará o comprimento da primeira matriz.
+ Erro `WRONGTYPE` se o valor no caminho não for uma matriz.
+ `NONEXISTENT JSON` erro se o caminho não existir.
+ Nulo se a chave do documento não existir.

**Exemplos**

 Sintaxe do caminho aprimorada:

```
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)
```

 Sintaxe do caminho restrita:

```
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
```