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

CKTIS / Java

Stream.findFirst: referência prática

Stream.findFirst: referência prática: findFirst é uma operação terminal de curto-circuito que devolve o primeiro elemento na ordem de encontro, ou Optional.empty quando o stream está vazio.

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

Sintaxe

Stream.findFirst(...)

findFirst é uma operação terminal de curto-circuito que devolve o primeiro elemento na ordem de encontro, ou Optional.empty quando o stream está vazio.

Usa-a quando a seleção tem de ser estável face à ordem da fonte, por exemplo para obter o primeiro registo que resta após filter.

Preservar a ordem de encontro pode limitar o desempenho paralelo; se o stream não tiver ordem pode ser devolvido qualquer elemento.

Um null selecionado lança NullPointerException, um stream vazio apenas devolve Optional.empty e a operação terminal consome o stream.

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("a", "b").findFirst();
        System.out.println(result.orElse("none"));
    }
}

Resultado

a

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

Fontes