Condividi tramite


ARRAY_CONTAINS_ANY (query NoSQL)

SI APPLICA A: NoSQL

Restituisce un valore booleano che indica se la prima matrice contiene uno degli elementi seguenti.

Sintassi

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

Argomenti

Descrizione
array_expr Espressione di matrice.
expr Espressione da cercare all'interno della matrice.
exprN (Facoltativo) Una o più espressioni aggiuntive da cercare all'interno della matrice.

Tipi restituiti

Restituisce un valore booleano.

Esempi

Nell'esempio seguente viene illustrato come verificare la presenza di valori o oggetti specifici in una matrice usando questa funzione.

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

Osservazioni:

  • Questa funzione di sistema non usa l'indice.