共用方式為


ARRAY_CONTAINS (NoSQL 查詢)

適用於:NoSQL

傳回布爾值,指出陣列是否包含指定的值。 您可以使用 函式內的布爾表達式,檢查物件的部分或完整相符專案。

語法

ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])  

引數

描述
arr_expr 數位表示式。
expr 在陣列內搜尋的表達式。
bool_expr 布爾表達式,指出搜尋是否應該檢查部分相符專案 (true) 或完整相符專案 (false)。 若未指定,則預設值為 false

傳回類型

傳回布爾值。

範例

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

SELECT VALUE {
    containsItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "coats"),
    missingItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "hoodies"),
    containsFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts", color: "blue" }),
    missingFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }),
    containsPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }, true),
    missingPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shorts", color: "blue" }, true)
}
[
  {
    "containsItem": true,
    "missingItem": false,
    "containsFullMatchObject": true,
    "missingFullMatchObject": false,
    "containsPartialMatchObject": true,
    "missingPartialMatchObject": false
  }
]

備註