ARRAY_CONTAINS_ALL(NoSQL 查询)
适用范围: NoSQL
返回一个布尔值,该值指示第一个数组是否包含以下所有元素。
语法
ARRAY_CONTAINS_ALL(<array_expr>, <expr> [, exprN])
参数
说明 | |
---|---|
array_expr |
一个数组表达式。 |
expr |
要在数组中搜索的表达式。 |
exprN (可选) |
要在数组中搜索的一个或多个额外表达式。 |
返回类型
返回一个布尔值。
示例
以下示例演示如何使用此函数检查数组中是否有特定的值或对象。
SELECT VALUE {
matchesEntireArray: ARRAY_CONTAINS_ALL([1, true, "3", [1,2,3]], 1, true, "3", [1,2,3]),
matchesSomeValues: ARRAY_CONTAINS_ALL([1, 2, 3, 4], 2, 3, 4, 5),
matchSingleValue: ARRAY_CONTAINS_ALL([1, 2, 3, 4], 1, undefined),
noMatches: ARRAY_CONTAINS_ALL([1, 2, 3, 4], 5, 6, 7, 8),
emptyArray: ARRAY_CONTAINS_ALL([], 1, 2, 3),
noMatchesUndefined: ARRAY_CONTAINS_ALL([1, 2, 3, 4], 5, undefined)
}
[
{
"matchesEntireArray": true,
"matchesSomeValues": false,
"noMatches": false,
"emptyArray": false,
"noMatchesUndefined": false
}
]
注解
- 此系统函数不使用索引。