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

CKTIS / Java

DoubleSummaryStatistics — estatísticas para valores double

DoubleSummaryStatistics recolhe a contagem, a soma, o mínimo, o máximo e a média de valores double. accept adiciona um valor e combine combina estatísticas.

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

Sintaxe

DoubleSummaryStatistics stats = new DoubleSummaryStatistics();
stats.accept(value);
stats.combine(other);
stats.getCount();
stats.getSum();
stats.getMin();
stats.getMax();
stats.getAverage();

java.util.DoubleSummaryStatistics é um acumulador mutável. accept(double) regista um valor; combine(other) combina estatísticas no objeto atual.

getCount() devolve long; getSum(), getMin(), getMax() e getAverage() devolvem double. Um objeto vazio tem contagem, soma e média iguais a zero, mínimo Double.POSITIVE_INFINITY e máximo Double.NEGATIVE_INFINITY.

NaN faz com que o mínimo, o máximo, a soma e a média sejam NaN. A soma e a média estão sujeitas a erros de vírgula flutuante; a ordem da soma não está especificada.

O objeto não é seguro para utilização concorrente: não atualize simultaneamente uma instância partilhada sem sincronização.

Exemplos

import java.util.DoubleSummaryStatistics;

public class Main {
    public static void main(String[] args) {
        DoubleSummaryStatistics stats = new DoubleSummaryStatistics();
        stats.accept(2.0);
        stats.accept(4.0);

        DoubleSummaryStatistics other = new DoubleSummaryStatistics();
        other.accept(6.0);
        stats.combine(other);

        System.out.println("count=" + stats.getCount());
        System.out.println("sum=" + stats.getSum());
        System.out.println("min=" + stats.getMin());
        System.out.println("max=" + stats.getMax());
        System.out.println("average=" + stats.getAverage());
    }
}

Resultado

count=3
sum=12.0
min=2.0
max=6.0
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