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

# CARDINALITY 函數
<a name="CARDINALITY"></a>

CARDINALITY 函數會傳回 ARRAY 或 MAP 表達式 (*expr*) 的大小。

此函數有助於尋找陣列的大小或長度。

## 語法
<a name="CARDINALITY-syntax"></a>

```
cardinality(expr)
```

## 引數
<a name="CARDINALITY-arguments"></a>

 *expr*   
ARRAY 或 MAP 表達式。

## 傳回值
<a name="CARDINALITY-returns"></a>

傳回陣列或映射的大小 (INTEGER)。

如果 `sizeOfNull` 設定為 `false`或 `enabled` 設定為 ，則函數會傳回 `NULL` null 輸入`true`。

否則，函數會傳回 null `-1` 輸入。使用預設設定時，函數會傳回 null `-1` 輸入。

## 範例
<a name="CARDINALITY-example"></a>

下列查詢會計算指定陣列中的基數或元素數量。陣列 (`'b', 'd', 'c', 'a'`) 有 4 個元素，因此此查詢的輸出會是 `4`。

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