CKTIS / Java
IntStream.allMatch(IntPredicate): testen of alle elementen aan een voorwaarde voldoen
Controleer of elke `int` in een stream aan een voorwaarde voldoet en ontdek waarom een lege stream `true` oplevert.
Versie: Java SE 21
Syntax
boolean allMatch(IntPredicate predicate)IntStream.allMatch(IntPredicate) is een instantiemethode van java.util.stream.IntStream. De methode vereist één argument van het type java.util.function.IntPredicate, zoals n -> n % 2 == 0. Het predicaat krijgt een primitieve int en geeft een boolean terug. De waarde hoeft niet in een Integer-object te worden verpakt.
De methode geeft true terug als alle elementen aan de voorwaarde voldoen en false als minstens één element er niet aan voldoet. Een lege stream geeft true terug zonder het predicaat aan te roepen: er is geen element dat niet aan de voorwaarde voldoet. Als de invoer niet leeg mag zijn, controleer dat dan apart.
Dit is een terminale operatie met kortsluitevaluatie. Eén element dat niet aan de voorwaarde voldoet, volstaat om false vast te stellen. De methode hoeft dus niet alle elementen te testen. Het predicaat mag de bron niet wijzigen en niet van veranderlijke toestand afhangen. Vertrouw niet op neveneffecten zoals het tellen van predicaataanroepen.
Na allMatch is de stream verbruikt, ook als niet alle elementen zijn getest. Maak een nieuwe stream uit dezelfde bron om dezelfde gegevens opnieuw te controleren.
Voorbeelden
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));
}
}
Resultaat
true false true
`n % 2 == 0` test of de rest bij deling door `2` nul is. De eerste stream bevat alleen even getallen (`true`), in de tweede voldoet `3` niet aan de voorwaarde (`false`) en de derde stream is leeg (`true`). Elke aanroep gebruikt een nieuwe stream.
Gerelateerde lessen
- Java · Les 63 · Basis · Versie: 2