array_match_any

デスクリプション

配列内の任意の要素が指定された条件に一致する場合はtrueを返し、そうでなければfalseを返します。配列にNULL要素が含まれており、すべての非NULL要素がfalseの場合は、NULLを返します。

Syntax

array_match_any(lambda, <arr> [, <arr> ...])

パラメータ

• lambda: 各要素に対してチェックする条件を定義するlambda式
• <arr>: チェックする1つ以上の配列。lambda関数はこれらの配列の各要素に適用されます

戻り値

nullable boolean値を返します：

• true 配列内のいずれかの要素が条件に一致する場合
• false 配列内のすべての要素が条件に一致しない場合
• NULL 配列にNULL要素が含まれており、すべての非NULL要素が条件に一致しない場合

例

-- Check if any number in array is greater than 5
mysql> SELECT array_match_any(x -> x > 5, [1, 2, 3, 4, 7]);
+----------------------------------------------+
| array_match_any(x -> x > 5, [1, 2, 3, 4, 7]) |
+----------------------------------------------+
|                                            1 |
+----------------------------------------------+

-- Check if any number in array is greater than corresponding numbers in another array
mysql> SELECT array_match_any((x, i) -> x > i, [1, 2, 3, 4, 5], [1, 2, 3, 4, 7]);
+--------------------------------------------------------------------+
| array_match_any((x, i) -> x > i, [1, 2, 3, 4, 5], [1, 2, 3, 4, 7]) |
+--------------------------------------------------------------------+
|                                                                  0 |
+--------------------------------------------------------------------+

mysql> SELECT array_match_any((x, i) -> i > x, [1, 2, 3, 4, 5], [1, 2, 3, 4, 7]);
+--------------------------------------------------------------------+
| array_match_any((x, i) -> i > x, [1, 2, 3, 4, 5], [1, 2, 3, 4, 7]) |
+--------------------------------------------------------------------+
|                                                                  1 |
+--------------------------------------------------------------------+

注釈

1. この関数は以下のようにNULL値を処理します：

   • NULL要素が存在し、すべての非NULL要素が条件に一致しない場合、NULLを返します
   • 非NULL要素のいずれかが条件に一致する場合、NULL要素に関係なくtrueを返します

2. この関数は以下の用途に有用です：

   • 配列内の要素が特定の条件を満たすかどうかをチェックする
   • 他の配列関数と組み合わせて複雑な配列操作を行う