ARRAY_CONTAINS_ANY (NoSQL クエリ)
適用対象: NoSQL
最初の配列に次のいずれかの要素が含まれているかどうかを示すブール値を返します。
構文
ARRAY_CONTAINS_ANY(<array_expr>, <expr> [, exprN])
引数
説明 | |
---|---|
array_expr |
配列式。 |
expr |
配列内で検索する式。 |
exprN (省略可能) |
配列内で検索する 1 つ以上の追加式。 |
戻り値の型
ブール値を返します。
例
次の例は、この関数を使用して、配列内の特定の値またはオブジェクトを確認する方法を示しています。
SELECT VALUE {
matchesEntireArray: ARRAY_CONTAINS_ANY([1, true, "3", [1,2,3]], 1, true, "3", [1,2,3]),
matchesSomeValues: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 2, 3, 4, 5),
matchSingleValue: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 1, undefined),
noMatches: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 5, 6, 7, 8),
emptyArray: ARRAY_CONTAINS_ANY([], 1, 2, 3),
noMatchesUndefined: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 5, undefined)
}
[
{
"matchesEntireArray": true,
"matchesSomeValues": true,
"matchSingleValue": true,
"noMatches": false,
"emptyArray": false
}
]
解説
- このシステム関数で、インデックスは使用されません。