WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen