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

備註

• 此系統函式受益於 範圍索引。

相關內容

• 系統函數
• ARRAY_CONCAT