ARRAY_CONTAINS_ANY (requête NoSQL)
S’APPLIQUE À : NoSQL
Retourne une valeur booléenne indique si le premier tableau contient l’un des éléments suivants.
Syntaxe
ARRAY_CONTAINS_ANY(<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_ANY([1, true, "3", [1,2,3]], 1, true, "3", [1,2,3]),
matchesSomeValues: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 2, 3, 4, 5),
matchSingleValue: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 1, undefined),
noMatches: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 5, 6, 7, 8),
emptyArray: ARRAY_CONTAINS_ANY([], 1, 2, 3),
noMatchesUndefined: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 5, undefined)
}
[
{
"matchesEntireArray": true,
"matchesSomeValues": true,
"matchSingleValue": true,
"noMatches": false,
"emptyArray": false
}
]
Notes
- Cette fonction système n’utilise pas l’index.