判断ARRAY数组a中是否所有元素都满足predicate条件。

命令格式

boolean all_match(array<T> <a>, function<T, boolean> <predicate>)

参数说明

  • a:必填。ARRAY数组。array<T>中的T指代ARRAY数组元素的数据类型,数组中的元素可以为任意类型。

  • predicate:必填。用于对ARRAY数组a中的元素进行判断的函数(内建函数或自定义函数)或表达式。输入参数的数据类型必须与ARRAY数组a中元素的数据类型一致。

返回值说明

返回BOOLEAN类型。返回规则如下:

  • 如果ARRAY数组a中所有的元素满足predicate条件或ARRAY数组为空,返回结果为True。

  • 如果ARRAY数组a中存在元素不满足predicate条件,返回结果为False。

  • 如果ARRAY数组a中存在元素为NULL,且其他元素都满足predicate条件,返回结果为NULL。

使用示例

  • 示例1:判断ARRAY数组array(4, 5, 6)的所有元素是否满足x x > 3条件(所有元素大于3)。命令示例如下。

    --返回true。
    select all_match(array(4, 5, 6), x -> x>3);
  • 示例2:ARRAY数组为空。命令示例如下。

    --返回true。
    select all_match(array(), x -> x>3);
  • 示例3:判断ARRAY数组array(1, 2, -10, 100, -30)的所有元素是否满足x-> x > 3条件。命令示例如下。

    --返回false。
    select all_match(array(1, 2, -10, 100, -30), x -> x>3);
  • 示例4:判断存在NULL元素的ARRAY数组array(10, 100, 30, null)的所有元素是否满足x-> x > 3条件。命令示例如下。

    --返回NULL。
    select all_match(array(10, 100, 30, null), x -> x>3);

相关函数

  • ALL_MATCH函数属于复杂类型函数,更多对复杂类型数据(例如ARRAY、MAP、STRUCT、JSON数据)的处理函数请参见复杂类型函数

  • ALL_MATCH函数使用示例中涉及->的使用,关于Lambda函数->的介绍,详情请参见Lambda函数