ARRAY_CONTAINS (NoSQL-query)
VAN TOEPASSING OP: NoSQL
Retourneert een Booleaanse waarde die aangeeft of de matrix de opgegeven waarde bevat. U kunt controleren op een gedeeltelijke of volledige overeenkomst van een object met behulp van een Booleaanse expressie binnen de functie.
Syntaxis
ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])
Argumenten
Beschrijving | |
---|---|
arr_expr |
Een matrixexpressie. |
expr |
Expressie om te zoeken in de matrix. |
bool_expr |
Een Booleaanse expressie die aangeeft of de zoekopdracht moet controleren op een gedeeltelijke overeenkomst (true ) of een volledige overeenkomst (false ). Als dit niet is opgegeven, is false de standaardwaarde . |
Retourtypen
Retourneert een Booleaanse waarde.
Voorbeelden
In het volgende voorbeeld ziet u hoe u met deze functie kunt controleren op specifieke waarden of objecten in een matrix.
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
}
]
Opmerkingen
- Deze systeemfunctie profiteert van een bereikindex.