ARRAY_MATCH_ALL

説明

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

構文

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

パラメータ

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

Return value

nullable boolean値を返します：

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

Examples

-- Check if all numbers in array are greater than 5
mysql> SELECT array_match_all(x -> x > 5, [1, 2, 3, 4, 7]);
+----------------------------------------------+
| array_match_all(x -> x > 5, [1, 2, 3, 4, 7]) |
+----------------------------------------------+
|                                            0 |
+----------------------------------------------+

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

注意事項

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

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

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

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