

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

# ARRAY\$1CONTAINS 函數
<a name="array_contains"></a>

ARRAY\$1CONTAINS 函數可用於對陣列資料結構執行基本成員資格檢查。當您需要檢查陣列中是否存在特定值時，ARRAY\$1CONTAINS 函數很有用。

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

```
array_contains(array, value)
```

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

 *陣列*  
要搜尋的 ARRAY。

 *值*  
具有與陣列元素共用最小常見類型的 運算式。

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

ARRAY\$1CONTAINS 函數會傳回 BOOLEAN。

如果值為 NULL，則結果為 NULL。

如果陣列中的任何元素為 NULL，如果值與任何其他元素不相符，則結果為 NULL。

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

下列範例會檢查陣列是否`[1, 2, 3]`包含值 `4`。由於陣列 `[1, 2, 3`】 不包含值 `4`，因此 array\$1contains 函數會傳回 `false`。

```
SELECT array_contains(array(1, 2, 3), 4)
false
```

下列範例會檢查陣列是否`[1, 2, 3]`包含值 `2`。由於陣列`[1, 2, 3]`確實包含值 `2`，因此 array\$1contains 函數會傳回 `true`。

```
SELECT array_contains(array(1, 2, 3), 2);
 true
```