База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Stream.findFirst: практическа справка

Stream.findFirst: практическа справка: findFirst е терминална операция със съкратено изчисление, която за подреден stream връща първия елемент по реда или Optional.empty при празен stream.

Версия: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Синтаксис

Stream.findFirst(...)

findFirst е терминална операция със съкратено изчисление, която за подреден stream връща първия елемент по реда или Optional.empty при празен stream.

Използвай я, когато изборът трябва да е стабилен спрямо реда на източника, например за първия запис, останал след filter.

Запазването на реда може да ограничи паралелната производителност; ако stream няма ред, може да се върне произволен елемент.

Избран null хвърля NullPointerException, празен stream само връща Optional.empty, а терминалната операция консумира stream.

Примерът използва документирания елемент в малка детерминистична програма и сравнява точния стандартен изход.

Примери

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

Резултат

a

Примерът използва документирания елемент в малка детерминистична програма и сравнява точния стандартен изход.

Източници