Teilen über


ARRAY_CONTAINS_ALL (NoSQL-Abfrage)

GILT FÜR: NoSQL

Gibt einen booleschen Wert zurück, der angibt, ob das erste Array alle folgenden Elemente enthält.

Syntax

ARRAY_CONTAINS_ALL(<array_expr>, <expr> [, exprN])

Argumente

BESCHREIBUNG
array_expr Ein Arrayausdruck.
expr Ausdruck, nach dem innerhalb des Arrays gesucht werden soll.
exprN (Optional) Mindestens ein zusätzlicher Ausdruck, nach dem innerhalb des Arrays gesucht werden soll.

Rückgabetypen

Gibt einen booleschen Wert zurück.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe dieser Funktion auf bestimmte Werte oder Objekte in einem Array überprüfen.

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

Hinweise

  • Diese Systemfunktion verwendet den Index nicht.