Détermine si au moins un élément du tableau ARRAY a satisfait la condition définie par predicate.
Syntaxe
boolean any_match(array<T> <a>, function<T, boolean> <predicate>)
Paramètres
a : obligatoire. Tableau de type ARRAY. Le paramètre
Tdansarray<T>représente le type de données des éléments du tableau ; ceux-ci peuvent être de n'importe quel type.predicate : obligatoire. Fonction (intégrée ou personnalisée) ou expression utilisée pour évaluer les éléments du tableau ARRAY a. Le type de données des paramètres d'entrée doit correspondre à celui des éléments du tableau ARRAY a.
Valeur de retour
La fonction renvoie une valeur de type BOOLEAN selon les règles suivantes :
Si un ou plusieurs éléments du tableau ARRAY a satisfont la condition predicate, la fonction renvoie True.
Si aucun élément du tableau ARRAY a ne satisfait la condition predicate ou si le tableau est vide, la fonction renvoie False.
Si le tableau ARRAY a contient des éléments NULL et qu'aucun autre élément ne satisfait la condition predicate, la fonction renvoie NULL.
Exemples
-
Exemple 1 : Vérifiez si des éléments du tableau ARRAY
array(1, 2, -10, 100, -30)satisfont la conditionxx > 3. Voici la commande :--返回true。 select any_match(array(1, 2, -10, 100, -30), x-> x > 3); -
Exemple 2 : Le tableau ARRAY est vide. Voici la commande :
--返回false。 select any_match(array(), x-> x > 3); -
Exemple 3 : Vérifiez si des éléments du tableau ARRAY
array(1, 2, -10, -20, -30)satisfont la conditionx-> x > 3. Voici la commande :--返回false。 select any_match(array(1, 2, -10, -20, -30), x-> x > 3); -
Exemple 4 : Vérifiez si des éléments du tableau ARRAY contenant des valeurs NULL
array(1, 2, null, -10)satisfont la conditionx-> x > 3. Voici la commande :--返回NULL。 select any_match(array(1, 2, null, -10), x-> x > 3);
Fonctions associées
La fonction ANY_MATCH appartient à la catégorie des fonctions de types complexes. Pour plus d'informations sur les fonctions de traitement des données de types complexes (telles que ARRAY, MAP, STRUCT et JSON), consultez la rubrique Complex type functions.
Les exemples d'utilisation de la fonction ANY_MATCH font appel à l'opérateur
->. Pour en savoir plus sur les fonctions Lambda utilisant->, consultez la rubrique Lambda functions.