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

# SIZE 函數
<a name="size"></a>

SIZE 函數會將現有的陣列、映射或字串做為引數，並傳回代表該資料結構大小或長度的單一值。它不會建立新的資料結構。它用於查詢和分析現有資料結構的屬性，而不是建立新的資料結構。

此函數有助於判斷陣列中的元素數量或字串長度。在 SQL 中使用陣列和其他資料結構時特別有用，因為它可讓您取得有關資料大小或基數的資訊。

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

```
size(expr)
```

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

 *expr*  
ARRAY、MAP 或 STRING 表達式。

## 傳回類型
<a name="size-return-type"></a>

SIZE 函數會傳回 INTEGER。

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

在此範例中，SIZE 函數會套用至陣列 `['b', 'd', 'c', 'a']`，並傳回值 `4`，這是陣列中的元素數目。

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

在此範例中，SIZE 函數會套用至映射 `{'a': 1, 'b': 2}`，並傳回值 `2`，這是映射中鍵值對的數量。

```
SELECT size(map('a', 1, 'b', 2));
 2
```

在此範例中，SIZE 函數會套用至字串 `'hello world'`，並傳回值 `11`，也就是字串中的字元數。

```
SELECT size('hello world');
11
```