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.