本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

ARRAY\$1CONTAINS 函数可用于对数组数据结构执行基本的成员资格检查。当你需要检查数组中是否存在特定值时，ARRAY\$1CONTAINS 函数很有用。

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

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

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

 *array*  
要搜索的数组。

 *值*  
一种表达式，其类型与数组元素共享最不常见的类型。

## 返回类型
<a name="array_contains-return-type"></a>

ARRAY\$1CONTAINS 函数返回一个布尔值。

如果值为空，则结果为空。

如果数组中的任何元素为 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
```