CKTIS / Java
IntStream.allMatch(IntPredicate): prüfen, ob alle Elemente passen
Prüfe, ob jeder `int`-Wert im Stream eine Bedingung erfüllt, und erfahre, warum ein leerer Stream `true` liefert.
Version: Java SE 21
Syntax
boolean allMatch(IntPredicate predicate)IntStream.allMatch(IntPredicate) ist eine Instanzmethode von java.util.stream.IntStream. Sie benötigt ein Argument vom Typ java.util.function.IntPredicate, etwa n -> n % 2 == 0. Das Prädikat erhält einen primitiven int-Wert und liefert einen boolean. Der Wert muss nicht in ein Integer-Objekt verpackt werden.
Die Methode liefert true, wenn alle Elemente die Bedingung erfüllen, und false, sobald feststeht, dass mindestens eines sie nicht erfüllt. Bei einem leeren Stream liefert sie true, ohne das Prädikat aufzurufen: Es gibt kein Element, das die Bedingung verletzt. Wenn die Eingabe nicht leer sein darf, prüfe das separat.
Es ist eine terminale Operation mit Kurzschlussauswertung. Ein einziges nicht passendes Element genügt für false, daher muss die Methode nicht alle Elemente prüfen. Das Prädikat darf die Quelle nicht verändern und nicht von veränderlichem Zustand abhängen. Verlasse dich nicht auf Nebeneffekte wie das Zählen der Prädikataufrufe.
Nach allMatch ist der Stream verbraucht, auch wenn nicht alle Elemente geprüft wurden. Um dieselben Daten erneut zu prüfen, erzeuge einen neuen Stream aus derselben Quelle.
Beispiele
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));
}
}
Ergebnis
true false true
`n % 2 == 0` prüft, ob bei der Division durch `2` der Rest null ist. Der erste Stream enthält nur gerade Zahlen (`true`), im zweiten besteht `3` den Test nicht (`false`), und der dritte ist leer (`true`). Jeder Aufruf verwendet einen neuen Stream.
Zugehörige Lektionen
- Java · Lektion 63 · Grundlagen · Version: 2