Partage via


ARRAY_CONTAINS (requête NoSQL)

S’APPLIQUE À : NoSQL

Retourne une valeur booléenne qui indique si le tableau contient la valeur spécifiée. Vous pouvez rechercher une correspondance partielle ou totale d’un objet en utilisant une expression booléenne dans la fonction.

Syntaxe

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

Arguments

Description
arr_expr Expression de tableau.
expr Expression à rechercher dans le tableau.
bool_expr Expression booléenne indiquant si la recherche doit porter sur une correspondance partielle (true) ou totale (false). Si elle n’est pas spécifiée, la valeur par défaut est false.

Types de retour

Retourne une valeur booléenne.

Exemples

L’exemple suivant montre comment rechercher des valeurs ou des objets spécifiques dans un tableau à l’aide de cette fonction.

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

Notes