ARRAY_CONTAINS_ANY (NoSQL 查詢)

適用於:NoSQL

傳回布爾值,指出第一個數位是否包含下列任一元素。

語法

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

引數

描述
array_expr 數位表示式。
expr 在陣列內搜尋的表達式。
exprN (選擇性) 要搜尋數位列內一或多個額外表達式。

傳回類型

傳回布爾值。

範例

下列範例說明如何使用這個函式檢查數位中的特定值或物件。

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

備註

  • 此系統函式不會使用索引。