ARRAY_CONTAINS (zapytanie NoSQL)
DOTYCZY: NoSQL
Zwraca wartość logiczną wskazującą, czy tablica zawiera określoną wartość. Możesz sprawdzić częściowe lub pełne dopasowanie obiektu przy użyciu wyrażenia logicznego w funkcji.
Składnia
ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])
Argumenty
opis | |
---|---|
arr_expr |
Wyrażenie tablicy. |
expr |
Wyrażenie do wyszukiwania w tablicy. |
bool_expr |
Wyrażenie logiczne wskazujące, czy wyszukiwanie powinno sprawdzać częściowe dopasowanie (true ) lub pełne dopasowanie (false ). Jeśli nie zostanie określony, wartość domyślna to false . |
Typy zwracane
Zwraca wartość logiczną.
Przykłady
Poniższy przykład ilustruje sposób sprawdzania określonych wartości lub obiektów w tablicy przy użyciu tej funkcji.
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
}
]