ARRAY_CONTAINS_ALL (запрос NoSQL)
ОБЛАСТЬ ПРИМЕНЕНИЯ: NoSQL
Возвращает логическое значение, указывающее, содержит ли первый массив все следующие элементы.
Синтаксис
ARRAY_CONTAINS_ALL(<array_expr>, <expr> [, exprN])
Аргументы
Description | |
---|---|
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
}
]
Замечания
- Эта системная функция не использует индекс.