Array contains（数组包含(Array contains)）¶

Supported in: Batch, Faster, Streaming

Returns true if the array contains the value.

Expression categories: Array, Boolean

Declared arguments¶

Array: The array to search within.
Expression\>
Value: The value to search for within the array.
Expression\

Output type: Boolean

Examples¶

Example 1: Base case¶

Argument values:

Array: part_ids
Value: BRR-123

part_ids	Output
[ AWE-112, BRR-123 ]	true
[ AWE-222, ABC-543 ]	false

Example 2: Base case¶

Description: Comparisons between different numeric types is allowed.

Argument values:

Array: ids
Value: 1

ids	Output
[ 1, 2 ]	true
[ 2, 3 ]	false

Example 3: Null case¶

Argument values:

Array: array
Value: value

array	value	Output
[ 1, 2, 3 ]	null	false
null	1	false
null	null	false
[ 1, 2, 3, null ]	null	true

Example 4: Edge case¶

Description: Float types should be cast to integers when checking for equality.

Argument values:

Array: ids
Value: 1.0

ids	Output
[ 1, 2 ]	true

Example 5: Edge case¶

Description: Float types should not be rounded when checking for equality.

Argument values:

Array: ids
Value: 1.2

ids	Output
[ 1, 2 ]	false

中文翻译¶

数组包含(Array contains)¶

支持：批处理(Batch)、快速处理(Faster)、流处理(Streaming)

如果数组中包含该值，则返回 true。

表达式类别： 数组(Array)、布尔(Boolean)

声明的参数¶

数组(Array)： 要搜索的数组。
表达式\>
值(Value)： 要在数组中搜索的值。
表达式\

输出类型： 布尔(Boolean)

示例¶

示例 1：基本情况¶

参数值：

数组(Array)： part_ids
值(Value)： BRR-123

part_ids	输出(Output)
[ AWE-112, BRR-123 ]	true
[ AWE-222, ABC-543 ]	false

示例 2：基本情况¶

描述： 允许在不同数值类型之间进行比较。

参数值：

数组(Array)： ids
值(Value)： 1

ids	输出(Output)
[ 1, 2 ]	true
[ 2, 3 ]	false

示例 3：空值情况¶

参数值：

数组(Array)： array
值(Value)： value

array	value	输出(Output)
[ 1, 2, 3 ]	null	false
null	1	false
null	null	false
[ 1, 2, 3, null ]	null	true

示例 4：边界情况¶

描述： 在检查相等性时，浮点类型应转换为整数。

参数值：

数组(Array)： ids
值(Value)： 1.0

ids	输出(Output)
[ 1, 2 ]	true

示例 5：边界情况¶

描述： 在检查相等性时，浮点类型不应进行四舍五入。

参数值：

数组(Array)： ids
值(Value)： 1.2

ids	输出(Output)
[ 1, 2 ]	false