ARRAY_CONTAINS_ANY (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Retorna um valor booleano que indica se a primeira matriz contém qualquer um dos elementos a seguir.

Sintaxe

ARRAY_CONTAINS_ANY(<array_expr>, <expr> [, exprN])

Argumentos

Descrição
array_expr Uma expressão de matriz.
expr Expressão a ser pesquisada dentro da matriz.
exprN (Opcional) Uma ou mais expressões extras para pesquisar dentro da matriz.

Tipos de retorno

Retorna um valor booliano.

Exemplos

O exemplo a seguir mostra como verificar se há valores ou objetos específicos em uma matriz usando essa função.

SELECT VALUE {
  matchesEntireArray: ARRAY_CONTAINS_ANY([1, true, "3", [1,2,3]], 1, true, "3", [1,2,3]),
  matchesSomeValues: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 2, 3, 4, 5),
  matchSingleValue: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 1, undefined),
  noMatches: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 5, 6, 7, 8),
  emptyArray: ARRAY_CONTAINS_ANY([], 1, 2, 3),
  noMatchesUndefined: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 5, undefined)
}

[
  {
    "matchesEntireArray": true,
    "matchesSomeValues": true,
    "matchSingleValue": true,
    "noMatches": false,
    "emptyArray": false
  }
]

Comentários

  • A função do sistema não utiliza o índice.

Conteúdo relacionado