Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Optional.filter: praktyczna referencja

Optional.filter: praktyczna referencja: Optional.filter(predicate) dla obecnej wartości zwraca Optional opisujący ją, gdy predykat jest true, a pusty Optional, gdy jest false; pusty odbiorca pozostaje pusty.

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

Składnia

Optional.filter(...)

Optional.filter(predicate) dla obecnej wartości zwraca Optional opisujący ją, gdy predykat jest true, a pusty Optional, gdy jest false; pusty odbiorca pozostaje pusty.

Stosuj filter do zachowania opcjonalnej wartości tylko wtedy, gdy spełnia warunek dziedzinowy, bez ręcznego rozgałęziania isPresent.

Predykat nie jest wykonywany dla pustego odbiorcy, więc nie umieszczaj w nim wymaganych efektów ubocznych; jego wyjątek jest przekazywany wywołującemu.

Argument predicate nie może być null i powoduje NullPointerException; obecna wartość spełniająca warunek nie jest kopiowana ani przekształcana.

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 value = java.util.Optional.of("Java").filter(text -> text.length() > 3);
        System.out.println(value.orElse("missing"));
    }
}

Wynik

Java

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

Źródła