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

CKTIS / Java

Stream.filter: referência prática

Stream.filter: referência prática: Stream.filter(predicate) é uma operação intermédia stateless que deixa passar apenas elementos para os quais o predicado devolve true.

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

Sintaxe

Stream.filter(...)

Stream.filter(predicate) é uma operação intermédia stateless que deixa passar apenas elementos para os quais o predicado devolve true.

Coloca-a cedo no pipeline para reduzir dados para map, distinct, collect ou redução, preservando a ordem de encontro da fonte.

É lazy: o predicado só executa ao iniciar uma operação terminal e pode não ver todos os elementos devido a curto-circuito ou otimização.

O predicado deve ser non-interfering e stateless e não pode ser null; se a fonte contiver null, o próprio predicado deve tratá-lo.

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 result = java.util.stream.Stream.of(1, 2, 3, 4).filter(n -> n % 2 == 0).toList();
        System.out.println(result);
    }
}

Resultado

[2, 4]

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

Fontes