Vérifie si tous les éléments du tableau ARRAY a satisfont la condition définie par predicate.
Syntaxe
boolean all_match(array<T> <a>, function<T, boolean> <predicate>)
Paramètres
a : obligatoire. Tableau ARRAY. Dans l'expression
array<T>,Treprésente le type de données des éléments du tableau. Ces éléments peuvent être de n'importe quel type.predicate : obligatoire. Fonction (intégrée ou personnalisée) ou expression servant à évaluer les éléments du tableau ARRAY a. Le type de données du paramètre d'entrée doit correspondre à celui des éléments du tableau ARRAY a.
Valeur renvoyée
La fonction renvoie une valeur de type BOOLEAN selon les règles suivantes :
Renvoie
Truesi tous les éléments du tableau ARRAY a satisfont la condition predicate ou si le tableau est vide.Renvoie
Falsesi au moins un élément du tableau ARRAY a ne satisfait pas la condition predicate.Renvoie
NULLsi le tableau ARRAY a contient un élément NULL et que tous les autres éléments satisfont la condition predicate.
Exemples
-
Exemple 1 : Vérifie si tous les éléments du tableau ARRAY
array(4, 5, 6)satisfont la conditionx -> x > 3(tous les éléments sont supérieurs à 3). Exemple de commande :--返回true。 select all_match(array(4, 5, 6), x -> x>3); -
Exemple 2 : Le tableau ARRAY est vide. Exemple de commande :
--返回true。 select all_match(array(), x -> x>3); -
Exemple 3 : Vérifie si tous les éléments du tableau ARRAY
array(1, 2, -10, 100, -30)satisfont la conditionx-> x > 3. Exemple de commande :--返回false。 select all_match(array(1, 2, -10, 100, -30), x -> x>3); -
Exemple 4 : Vérifie si tous les éléments du tableau ARRAY contenant une valeur NULL,
array(10, 100, 30, null), satisfont la conditionx-> x > 3. Exemple de commande :--返回NULL。 select all_match(array(10, 100, 30, null), x -> x>3);
Fonctions connexes
La fonction ALL_MATCH fait partie des fonctions de type complexe. 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 ALL_MATCH font appel à l'opérateur
->. Pour en savoir plus sur les fonctions Lambda utilisant l'opérateur->, consultez la rubrique Lambda functions.