Compartir a través de


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.