ARRAY_CONTAINS_ALL (consulta NoSQL)
SE APLICA A: NoSQL
Devuelve un valor booleano que indica si la primera matriz contiene todos los elementos siguientes.
Sintaxis
ARRAY_CONTAINS_ALL(<array_expr>, <expr> [, exprN])
Argumentos
Descripción | |
---|---|
array_expr |
Una expresión de matriz. |
expr |
Expresión que se va a buscar en la matriz. |
exprN (Opcional) |
Una o varias expresiones adicionales para buscar dentro de la matriz. |
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 {
matchesEntireArray: ARRAY_CONTAINS_ALL([1, true, "3", [1,2,3]], 1, true, "3", [1,2,3]),
matchesSomeValues: ARRAY_CONTAINS_ALL([1, 2, 3, 4], 2, 3, 4, 5),
matchSingleValue: ARRAY_CONTAINS_ALL([1, 2, 3, 4], 1, undefined),
noMatches: ARRAY_CONTAINS_ALL([1, 2, 3, 4], 5, 6, 7, 8),
emptyArray: ARRAY_CONTAINS_ALL([], 1, 2, 3),
noMatchesUndefined: ARRAY_CONTAINS_ALL([1, 2, 3, 4], 5, undefined)
}
[
{
"matchesEntireArray": true,
"matchesSomeValues": false,
"noMatches": false,
"emptyArray": false,
"noMatchesUndefined": false
}
]
Comentarios
- La función del sistema no emplea el índice.