

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Fonction CARDINALITY
<a name="CARDINALITY"></a>

La fonction CARDINALITY renvoie la taille d'une expression ARRAY ou MAP (*expr*).

Cette fonction est utile pour déterminer la taille ou la longueur d'un tableau.

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

```
cardinality(expr)
```

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

 *expr*   
Expression ARRAY ou MAP.

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

Renvoie la taille d'un tableau ou d'une carte (INTEGER). 

La fonction renvoie `NULL` une entrée nulle si elle `sizeOfNull` est définie sur `false` ou `enabled` est définie sur`true`. 

Dans le cas contraire, la fonction renvoie `-1` une entrée nulle. Avec les paramètres par défaut, la fonction renvoie `-1` une entrée nulle.

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

La requête suivante calcule la cardinalité, ou le nombre d'éléments, dans le tableau donné. Le tableau (`'b', 'd', 'c', 'a'`) comporte 4 éléments, donc le résultat de cette requête serait`4`.

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