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

# Função CARDINALITY
<a name="CARDINALITY"></a>

A função CARDINALITY retorna o tamanho de uma expressão ARRAY ou MAP (*expr*).

Essa função é útil para encontrar o tamanho ou o comprimento de uma matriz.

## Sintaxe
<a name="CARDINALITY-syntax"></a>

```
cardinality(expr)
```

## Argumentos
<a name="CARDINALITY-arguments"></a>

 *expr*   
Uma expressão ARRAY ou MAP.

## Retornos
<a name="CARDINALITY-returns"></a>

Retorna o tamanho de uma matriz ou mapa (INTEGER). 

A função retorna `NULL` para entrada nula se `sizeOfNull` estiver definida como `false` ou `enabled` definida como. `true` 

Caso contrário, a função retornará `-1` para entrada nula. Com as configurações padrão, a função retorna `-1` para entrada nula.

## Exemplo
<a name="CARDINALITY-example"></a>

A consulta a seguir calcula a cardinalidade, ou o número de elementos, na matriz fornecida. O array (`'b', 'd', 'c', 'a'`) tem 4 elementos, então a saída dessa consulta seria`4`.

```
SELECT cardinality(array('b', 'd', 'c', 'a'));
 4
```