CKTIS / Java
IntStream.allMatch(IntPredicate) : vérifier que tous les éléments satisfont une condition
Vérifiez si chaque valeur `int` d’un flux satisfait une condition et comprenez pourquoi un flux vide renvoie `true`.
Version : Java SE 21
Syntaxe
boolean allMatch(IntPredicate predicate)IntStream.allMatch(IntPredicate) est une méthode d’instance de java.util.stream.IntStream. Elle exige un argument de type java.util.function.IntPredicate, par exemple n -> n % 2 == 0. Le prédicat reçoit un int primitif et renvoie un boolean, sans qu’il soit nécessaire de convertir la valeur en objet Integer.
La méthode renvoie true si tous les éléments satisfont la condition et false si au moins un ne la satisfait pas. Un flux vide donne true sans appel du prédicat : aucun élément ne contredit la condition. Si l’entrée doit être non vide, vérifiez-le séparément.
C’est une opération terminale à court-circuit. Un seul élément qui échoue suffit pour établir le résultat false, donc la méthode peut ne pas tester tous les éléments. Le prédicat ne doit ni modifier la source ni dépendre d’un état qui change. Ne comptez pas sur des effets de bord tels que le comptage des appels du prédicat.
Après allMatch, le flux est consommé, même si tous les éléments n’ont pas été testés. Pour vérifier les mêmes données à nouveau, créez un nouveau flux à partir de la même source.
Exemples
import java.util.function.IntPredicate;
import java.util.stream.IntStream;
public class Main {
public static void main(String[] args) {
IntPredicate isEven = n -> n % 2 == 0;
System.out.println(IntStream.of(2, 4, 6).allMatch(isEven));
System.out.println(IntStream.of(2, 3, 6).allMatch(isEven));
System.out.println(IntStream.empty().allMatch(isEven));
}
}
Résultat
true false true
`n % 2 == 0` vérifie que le reste de la division par `2` est nul. Le premier flux ne contient que des nombres pairs (`true`), `3` échoue au test dans le deuxième (`false`) et le troisième flux est vide (`true`). Chaque appel utilise un nouveau flux.
Leçons associées
- Java · Leçon 63 · Débutant · Version : 2