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

CKTIS / Java

Statistiques sur des valeurs double avec Collectors.summarizingDouble

Calculez l’effectif, la somme, le minimum, le maximum et la moyenne en un seul parcours d’un flux d’objets, en précisant comment extraire un double de chaque élément.

Version : Java SE 21

Syntaxe

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

Collectors.summarizingDouble() est une notation abrégée pour la méthode statique de java.util.stream.Collectors. Elle n’a pas de surcharge sans argument : elle exige une ToDoubleFunction<? super T> qui produit un double primitif pour chaque élément du flux. Vous pouvez fournir cette fonction sous forme de lambda ou de référence de méthode.

L’appel crée un collecteur. Passez-le à l’opération terminale Stream.collect(...) pour obtenir un objet java.util.DoubleSummaryStatistics en un seul parcours. getCount() renvoie l’effectif sous forme de long ; getSum(), getMin(), getMax() et getAverage() renvoient la somme, le minimum, le maximum et la moyenne arithmétique sous forme de double. Si vous disposez déjà d’un DoubleStream, appelez sa méthode summaryStatistics() sans fonction de transformation.

Pour un flux vide, l’effectif vaut 0, la somme et la moyenne valent 0.0, le minimum vaut Double.POSITIVE_INFINITY et le maximum vaut Double.NEGATIVE_INFINITY. Testez getCount() == 0 avant d’interpréter le minimum et le maximum comme des valeurs réellement présentes dans les données.

À cause des arrondis en virgule flottante, la somme et la moyenne peuvent dépendre de l’ordre des additions. Si l’une des valeurs produites par la fonction est NaN, la somme, le minimum, le maximum et la moyenne valent tous NaN ; cette valeur reste comptabilisée.

Exemples

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

Résultat

count=3
sum=7.5
min=1.5
max=3.5
average=2.5

`Parcel::weightKg` extrait le poids de chaque colis en kilogrammes. Le collecteur compte les trois valeurs et calcule leurs statistiques ; l’exemple affiche chaque résultat séparément.

Leçons associées

  • Java · Leçon 67 · Débutant · Version : 2

Sources