ARRAY_CONTAINS (consulta NoSQL)
APLICA-SE A: NoSQL
Retorna um valor booliano que indica se a matriz contém o valor especificado. Você pode verificar uma correspondência parcial ou completa de um objeto usando uma expressão booliana na função.
Sintaxe
ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])
Argumentos
Descrição | |
---|---|
arr_expr |
Uma expressão de matriz. |
expr |
Expressão a ser pesquisada dentro da matriz. |
bool_expr |
Uma expressão booliana que indica se a pesquisa deve verificar se há uma correspondência parcial (true ) ou uma correspondência completa (false ). Se esse campo não for especificado, o valor padrão será false . |
Tipos de retorno
Retorna um valor booliano.
Exemplos
O exemplo a seguir mostra como verificar se há valores ou objetos específicos em uma matriz usando essa função.
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
}
]
Comentários
- Essa função do sistema se beneficia de um índice de intervalo.