Поделиться через


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
  }
]

Замечания

  • Эта системная функция не использует индекс.