Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Optional.filter: referência prática

Optional.filter: referência prática: Optional.filter(predicate) devolve um Optional que descreve o valor presente se satisfizer o predicado, um Optional vazio caso contrário, e mantém vazio um recetor vazio.

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

Sintaxe

Optional.filter(...)

Optional.filter(predicate) devolve um Optional que descreve o valor presente se satisfizer o predicado, um Optional vazio caso contrário, e mantém vazio um recetor vazio.

Usa filter para conservar um valor opcional apenas quando cumpre uma condição do domínio, sem ramificar manualmente com isPresent.

O predicado não é executado num recetor vazio, portanto não coloques nele efeitos laterais obrigatórios; as suas exceções propagam-se.

Um argumento predicate null causa NullPointerException; o valor presente aceite não é copiado nem transformado.

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Exemplos

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

Resultado

Java

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Fontes