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

CKTIS / Java

DoubleStream — filtrar, contar e calcular a média

DoubleStream processa valores primitivos double numa pipeline preguiçosa. Aprende a criar um fluxo, a filtrá-lo e a usar as operações terminais count() e average().

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

static DoubleStream of(double t)
static DoubleStream of(double... values)
DoubleStream filter(DoublePredicate predicate)
long count()
OptionalDouble average()

java.util.stream.DoubleStream é um fluxo de valores primitivos double, e não de objetos Double como em Stream<Double>. Não armazena dados: descreve o seu processamento. DoubleStream.of(double t) cria um fluxo sequencial com um único elemento, enquanto DoubleStream.of(double... values) cria um fluxo sequencial e ordenado com os valores fornecidos.

DoubleStream.filter(DoublePredicate predicate) é uma operação intermédia preguiçosa: conserva os valores que satisfazem a condição. O predicado deve ser sem estado e não pode modificar a origem. Uma operação terminal desencadeia o processamento. DoubleStream.count() devolve o número de elementos como long; um fluxo vazio produz 0.

DoubleStream.average() é uma operação terminal que devolve a média aritmética num OptionalDouble. Um fluxo vazio produz um resultado opcional vazio, não uma média igual a zero. orElse(-1.0) seleciona explicitamente um valor alternativo. Os cálculos de vírgula flutuante podem envolver arredondamentos; a média também pode ser NaN.

Após uma operação terminal, a pipeline fica consumida: não chames count() e average() no mesmo fluxo. O exemplo cria dois fluxos separados. Depois da filtragem, restam 2.0, 4.0 e 6.0, pelo que os resultados esperados são 3 e 4.0.

Exemplos

import java.util.OptionalDouble;
import java.util.stream.DoubleStream;

public class Main {
    public static void main(String[] args) {
        long count = DoubleStream.of(1.0, 2.0, 4.0, 6.0)
                .filter(x -> x >= 2.0)
                .count();

        OptionalDouble average = DoubleStream.of(1.0, 2.0, 4.0, 6.0)
                .filter(x -> x >= 2.0)
                .average();

        System.out.println("count=" + count);
        System.out.println("average=" + average.orElse(-1.0));
    }
}

Resultado

count=3
average=4.0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes