WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Stream.findFirst: praktische Referenz

Stream.findFirst: praktische Referenz: findFirst ist eine kurzschließende Terminaloperation und liefert beim geordneten Stream das erste Element der Begegnungsreihenfolge, sonst bei Leere Optional.empty.

Version: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Syntax

Stream.findFirst(...)

findFirst ist eine kurzschließende Terminaloperation und liefert beim geordneten Stream das erste Element der Begegnungsreihenfolge, sonst bei Leere Optional.empty.

Nutze sie, wenn die Auswahl bezüglich der Quellreihenfolge stabil sein muss, etwa für den ersten nach filter verbleibenden Datensatz.

Die Wahrung der Begegnungsreihenfolge kann parallele Leistung begrenzen; besitzt der Stream keine Reihenfolge, darf jedes Element zurückkommen.

Ein gewähltes null verursacht NullPointerException, ein leerer Stream liefert lediglich Optional.empty, und die Terminaloperation verbraucht den Stream.

Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.

Beispiele

public class Main {
    public static void main(String[] args) throws Exception {
        var result = java.util.stream.Stream.of("a", "b").findFirst();
        System.out.println(result.orElse("none"));
    }
}

Ergebnis

a

Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.

Quellen