ARRAY_CONTAINS (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Devolve um valor booleano que indica se a matriz contém o valor especificado. Pode verificar a existência de uma correspondência parcial ou completa de um objeto com uma expressão booleana dentro da função.

Sintaxe

ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])

Argumentos

Description
arr_expr Uma expressão de matriz.
expr Expressão a procurar na matriz.
bool_expr Uma expressão booleana que indica se a pesquisa deve verificar se existe uma correspondência parcial (true) ou uma correspondência completa (false). Se não for especificado, o valor predefinido é false.

Tipos de devolução

Devolve um valor booleano.

Exemplos

O exemplo seguinte ilustra como verificar se existem valores ou objetos específicos numa matriz com esta 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
  }
]

Observações

Conteúdo relacionado