跳到主要内容
版本:Latest-3.3

all_match

功能

判断数组中的所有元素是否都匹配谓词中 (predicate) 指定的条件。

  • 如果所有元素都匹配或数组为空,则返回 true (1)。

  • 如果有一个或多个元素不匹配,则返回 false (0)。

  • 如果数组中有元素为 NULL,而其他元素都满足条件,则返回 NULL。

该函数从 3.0.6 版本开始支持。

语法

all_match(lambda_function, arr1, arr2...)

判断数组中的所有元素是否都匹配 Lambda 表达式中指定的条件。

参数说明

  • arr: 进行判断的数组。

  • lambda_function: 作为匹配条件的 Lambda 表达式。

返回值说明

返回 BOOLEAN 类型的值。

使用说明

  • 关于 Lambda 表达式的使用注意事项,参见 array_map()
  • 如果输入的数组为 NULL 或者 Lambda 表达式的结果为 NULL,则返回 NULL。
  • 如果第一个数组为空,则返回 true
  • 如果要将该函数应用在 MAP 上,可以将 all_match((k,v)->k>v,map) 改写为 all_match(map_values(transform_values((k,v)->k>v, map)))。例如,select all_match(map_values(transform_values((k,v)->k>v, map{2:1}))); 返回 1。

示例

判断数组 x 中的元素是否都小于数组 y 中的元素。

select all_match((x,y) -> x < y, [1,2,-8], [4,5,6]);
+---------------------------------------------------+
| all_match((x, y) -> x < y, [1, 2, -8], [4, 5, 6]) |
+---------------------------------------------------+
| 1 |
+---------------------------------------------------+

select all_match((x,y) -> x < y, [1,2,null], [4,5,6]);
+-----------------------------------------------------+
| all_match((x, y) -> x < y, [1, 2, NULL], [4, 5, 6]) |
+-----------------------------------------------------+
| NULL |
+-----------------------------------------------------+

select all_match((x,y) -> x < y, [1,2,8], [4,5,6]);
+--------------------------------------------------+
| all_match((x, y) -> x < y, [1, 2, 8], [4, 5, 6]) |
+--------------------------------------------------+
| 0 |
+--------------------------------------------------+

select all_match((x,y) -> x < y, [], []);
+------------------------------------+
| all_match((x, y) -> x < y, [], []) |
+------------------------------------+
| 1 |
+------------------------------------+

select all_match((x,y) -> x < y, null, [4,5,6]);
+---------------------------------------------+
| all_match((x, y) -> x < y, NULL, [4, 5, 6]) |
+---------------------------------------------+
| NULL |
+---------------------------------------------+