ARRAY_CONTAINS (consulta NoSQL)

SE APLICA A: NoSQL

Devuelve un valor booleano que indica si la matriz contiene el valor especificado. Puede buscar una coincidencia parcial o total de un objeto mediante el uso de una expresión booleana dentro de la función.

Sintaxis

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

Argumentos

Descripción
arr_expr Una expresión de matriz.
expr Expresión que se va a buscar en la matriz.
bool_expr Expresión booleana que indica si la búsqueda debe comprobar una coincidencia parcial (true) o una coincidencia completa (false). Si no se especifica, el valor predeterminado es false.

Tipos de valores devueltos

Devuelve un valor booleano.

Ejemplos

En el ejemplo siguiente, se muestra cómo comprobar si hay valores u objetos específicos en una matriz mediante esta función.

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
  }
]

Comentarios