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
- Esta función del sistema se beneficia de un índice de intervalo.
Contenido relacionado
- System functions (Funciones del sistema)
ARRAY_CONCAT