ARRAY_CONTAINS (query NoSQL)
SI APPLICA A: NoSQL
Restituisce un valore booleano che indica se la matrice contiene il valore specificato. È possibile verificare la presenza di una corrispondenza parziale o completa di un oggetto usando un'espressione booleana all'interno della funzione.
Sintassi
ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])
Argomenti
Descrizione | |
---|---|
arr_expr |
Espressione di matrice. |
expr |
Espressione da cercare all'interno della matrice. |
bool_expr |
Espressione booleana che indica se la ricerca deve cercare una corrispondenza parziale (true ) o una corrispondenza completa (false ). Se non è specificato, il valore predefinito è false . |
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 {
containsItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "coats"),
missingItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "hoodies"),
containsFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts", color: "blue" }),
missingFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }),
containsPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }, true),
missingPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shorts", color: "blue" }, true)
}
[
{
"containsItem": true,
"missingItem": false,
"containsFullMatchObject": true,
"missingFullMatchObject": false,
"containsPartialMatchObject": true,
"missingPartialMatchObject": false
}
]
Osservazioni:
- Questa funzione di sistema trae vantaggio da un indice di intervallo.