ARRAY_CONTAINS_ALL (requête NoSQL)
S’APPLIQUE À : NoSQL
Retourne une valeur booléenne indique si le premier tableau contient tous les éléments suivants.
Syntaxe
ARRAY_CONTAINS_ALL(<array_expr>, <expr> [, exprN])
Arguments
Description | |
---|---|
array_expr |
Expression de tableau. |
expr |
Expression à rechercher dans le tableau. |
exprN (Facultatif) |
Une ou plusieurs expressions supplémentaires à rechercher dans le tableau. |
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 {
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
}
]
Notes
- Cette fonction système n’utilise pas l’index.