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

CKTIS / Java

Stream.findAny: referência prática

Stream.findAny: referência prática: findAny é uma operação terminal de curto-circuito que devolve um Optional com algum elemento do stream, ou vazio se o stream estiver vazio.

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

Sintaxe

Stream.findAny(...)

findAny é uma operação terminal de curto-circuito que devolve um Optional com algum elemento do stream, ou vazio se o stream estiver vazio.

Usa-a quando qualquer elemento correspondente serve e a posição é irrelevante, sobretudo para não impor ordem de encontro num pipeline paralelo.

O resultado é explicitamente não determinístico e execuções sobre fontes equivalentes podem escolher elementos diferentes; não é uma seleção estável.

Selecionar um elemento null lança NullPointerException e o stream fica consumido após o terminal; um stream vazio produz Optional.empty.

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").findAny();
        System.out.println(result.isPresent());
    }
}

Resultado

true

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

Fontes