Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Stream.findFirst: praktyczna referencja

Stream.findFirst: praktyczna referencja: findFirst jest krótko spiętą operacją terminalną, która dla uporządkowanego stream zwraca pierwszy element w encounter order, a dla pustego Optional.empty.

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

Składnia

Stream.findFirst(...)

findFirst jest krótko spiętą operacją terminalną, która dla uporządkowanego stream zwraca pierwszy element w encounter order, a dla pustego Optional.empty.

Stosuj ją, gdy wybór musi być stabilny względem kolejności źródła, na przykład po filter do pobrania pierwszego rekordu spełniającego warunek.

Zachowanie encounter order może ograniczać wydajność równoległą; dla nieuporządkowanego stream metoda może zwrócić dowolny element.

Wybrany null powoduje NullPointerException, pusty stream nie uruchamia wartości zastępczej sam z siebie, a terminal zużywa stream.

Przykład sprawdza opisywany element w małym, deterministycznym programie i porównuje dokładny standardowy wynik.

Przykłady

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"));
    }
}

Wynik

a

Przykład sprawdza opisywany element w małym, deterministycznym programie i porównuje dokładny standardowy wynik.

Źródła