Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Stream.findFirst: référence pratique

Stream.findFirst: référence pratique: findFirst est une opération terminale à court-circuit qui rend le premier élément dans l’ordre de parcours d’un stream ordonné, ou Optional.empty à vide.

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

Syntaxe

Stream.findFirst(...)

findFirst est une opération terminale à court-circuit qui rend le premier élément dans l’ordre de parcours d’un stream ordonné, ou Optional.empty à vide.

Utilise-la lorsque le choix doit rester stable par rapport à l’ordre source, par exemple pour le premier enregistrement conservé par filter.

Respecter l’ordre peut limiter les performances parallèles ; si le stream n’a pas d’ordre de parcours, n’importe quel élément peut être rendu.

Un null sélectionné lève NullPointerException, un stream vide rend seulement Optional.empty et l’opération terminale consomme le stream.

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Exemples

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

Résultat

a

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Sources