Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Estadísticas de valores double con Collectors.summarizingDouble

Obtén el recuento, la suma, el mínimo, el máximo y la media en un solo recorrido de un flujo de objetos, indicando cómo extraer un double de cada elemento.

Versión: Java SE 21

Sintaxis

public static <T> Collector<T, ?, DoubleSummaryStatistics> summarizingDouble(ToDoubleFunction<? super T> mapper)

Collectors.summarizingDouble() es una forma abreviada de nombrar el método estático de java.util.stream.Collectors. No tiene una sobrecarga sin argumentos: requiere una ToDoubleFunction<? super T> que produzca un double primitivo por cada elemento del flujo. Puedes pasar esta función como una lambda o una referencia a un método.

La llamada crea un colector. Pásalo a la operación terminal Stream.collect(...) para obtener un objeto java.util.DoubleSummaryStatistics en un solo recorrido. getCount() devuelve el recuento como long; getSum(), getMin(), getMax() y getAverage() devuelven la suma, el mínimo, el máximo y la media aritmética como valores double. Si ya tienes un DoubleStream, llama a su método summaryStatistics() sin función de transformación.

Si el flujo está vacío, el recuento es 0, la suma y la media son 0.0, el mínimo es Double.POSITIVE_INFINITY y el máximo es Double.NEGATIVE_INFINITY. Comprueba getCount() == 0 antes de interpretar el mínimo y el máximo como valores presentes en los datos.

Debido al redondeo de coma flotante, la suma y la media pueden depender del orden de las sumas. Si algún valor producido por la función es NaN, la suma, el mínimo, el máximo y la media serán NaN; ese valor también se incluye en el recuento.

Ejemplos

import java.util.DoubleSummaryStatistics;
import java.util.List;
import java.util.stream.Collectors;

public class Main {
    record Parcel(double weightKg) {}

    public static void main(String[] args) {
        List<Parcel> parcels = List.of(
                new Parcel(1.5), new Parcel(2.5), new Parcel(3.5));

        DoubleSummaryStatistics stats = parcels.stream()
                .collect(Collectors.summarizingDouble(Parcel::weightKg));

        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=7.5
min=1.5
max=3.5
average=2.5

`Parcel::weightKg` extrae el peso en kilogramos de cada paquete. El colector cuenta los tres valores y calcula sus estadísticas; el ejemplo imprime cada resultado por separado.

Lecciones relacionadas

  • Java · Lección 67 · Básico · Versión: 2

Fuentes