ARRAY_CONTAINS_ALL (NoSQL クエリ)

  • [アーティクル]

適用対象: NoSQL

最初の配列に次のすべての要素が含まれているかどうかを示すブール値を返します。

構文

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

引数

説明
array_expr 配列式。
expr 配列内で検索する式。
exprN (省略可能) 配列内で検索する 1 つ以上の追加式。

戻り値の型

ブール値を返します。

例

次の例は、この関数を使用して、配列内の特定の値またはオブジェクトを確認する方法を示しています。

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

解説

  • このシステム関数で、インデックスは使用されません。

関連するコンテンツ