WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Optional.filter: praktische Referenz

Optional.filter: praktische Referenz: Optional.filter(predicate) liefert bei vorhandenem passenden Wert ein ihn beschreibendes Optional, sonst ein leeres Optional; ein leerer Empfänger bleibt leer.

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

Syntax

Optional.filter(...)

Optional.filter(predicate) liefert bei vorhandenem passenden Wert ein ihn beschreibendes Optional, sonst ein leeres Optional; ein leerer Empfänger bleibt leer.

Nutze filter, um einen optionalen Wert nur bei erfüllter Fachbedingung zu behalten, ohne manuell auf isPresent zu verzweigen.

Bei leerem Empfänger wird das Prädikat nicht ausgeführt; notwendige Nebeneffekte gehören daher nicht hinein. Seine Ausnahme wird weitergereicht.

Ein null-Prädikat verursacht NullPointerException; ein vorhandener passender Wert wird weder kopiert noch umgewandelt.

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

Ergebnis

Java

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

Quellen