ARRAY_CONTAINS_ANY (NoSQL-Abfrage)

GILT FÜR: NoSQL

Gibt einen booleschen Wert an, der angibt, ob das erste Array eines der folgenden Elemente enthält.

Syntax

ARRAY_CONTAINS_ANY(<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_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
  }
]

Hinweise

  • Diese Systemfunktion verwendet den Index nicht.