HOWTO · Java

Calculer la moyenne en Java

Ce tutoriel montre comment calculer la moyenne en Java.

Sur cette page

La moyenne arithmétique, généralement appelée moyenne, correspond à la somme des valeurs divisée par leur nombre. En Java, calculez-la en additionnant les valeurs, puis en divisant le total par le nombre d’éléments, en utilisant l’arithmétique à virgule flottante. Une boucle convient aux tableaux, l’API Stream offre une solution concise, et une méthode réutilisable ou un flux de liste permet de réutiliser le même calcul.

Les éléments de preuve d’exécution fournis consignent quatre exécutions réussies. Chacune affiche Average: 30.0 (libellé conservé en anglais) et se termine avec le code de sortie 0.

Calculer une moyenne avec une boucle

Une boucle permet de contrôler directement le total courant et le nombre de valeurs. Convertissez le total en double avant la division afin que Java n’effectue pas de division entière. Cet exemple utilise de petits entiers ; pour des totaux beaucoup plus élevés, choisissez un accumulateur ayant une plage suffisante ou un type décimal adapté à la précision requise.

Exécutez cet exemple :

Le code et les libellés ou sorties affichés dans cette section restent en anglais.

public class AverageLoop {
    public static void main(String[] args) {
        int[] numbers = {10, 20, 30, 40, 50};
        double sum = 0.0;

        for (int number : numbers) {
            sum += number;
        }

        double average = sum / numbers.length;
        System.out.println("Average: " + average);
    }
}

La boucle for améliorée parcourt chaque élément une seule fois. Comme sum est un double, chaque entier ajouté est converti en valeur à virgule flottante ; la division par la longueur du tableau conserve donc les résultats fractionnaires. La longueur d’un tableau est une propriété, qui s’écrit numbers.length.

Calculer une moyenne avec les flux

Pour un int[], Arrays.stream crée un IntStream, dont l’opération average renvoie un OptionalDouble. Cet objet optionnel signale explicitement le cas où il n’y a aucune valeur. Choisissez le comportement souhaité pour votre application au lieu de considérer automatiquement zéro comme la moyenne.

Le code et les libellés ou sorties affichés dans cette section restent en anglais.

import java.util.Arrays;
import java.util.OptionalDouble;

public class AverageStream {
    public static void main(String[] args) {
        int[] numbers = {10, 20, 30, 40, 50};
        OptionalDouble result = Arrays.stream(numbers).average();

        if (result.isPresent()) {
            System.out.println("Average: " + result.getAsDouble());
        } else {
            System.out.println("No average is defined for this input.");
        }
    }
}

L’API Stream et Arrays.stream(int[]) sont disponibles à partir de Java 8. Lorsque le tableau contient des valeurs, average() calcule un résultat de type double. Si le tableau est vide, l’objet optionnel ne contient aucune valeur et le programme exécute l’autre branche.

Gérer les entrées vides et les types numériques

Une collection vide n’a pas de moyenne arithmétique, puisqu’il n’y a aucune valeur par laquelle diviser la somme. Vérifiez la longueur avant la division ou utilisez l’OptionalDouble vide renvoyé par un flux. Si la méthode doit renvoyer un nombre, documentez la valeur de remplacement comme un choix propre à l’application : zéro peut être une moyenne valide pour certaines données non vides et ne devrait pas automatiquement signifier « aucune valeur ».

En Java, la division entière supprime la partie fractionnaire : 5 / 2 donne 2. Convertissez au moins un opérande en valeur à virgule flottante avant la division, comme dans 5.0 / 2, pour obtenir 2.5. Pour des entrées à virgule flottante, utilisez un accumulateur double si sa précision et sa plage conviennent au besoin. Un total de type double évite les dépassements de capacité habituels des sommes d’entiers, mais l’arithmétique à virgule flottante a une précision et une plage limitées. Les applications qui exigent une arithmétique décimale exacte peuvent utiliser BigDecimal avec une règle d’arrondi explicite.

Placer le calcul de la moyenne dans une méthode réutilisable

Déplacez le calcul dans une méthode lorsque plusieurs parties du programme doivent appliquer le même comportement. Cette version renvoie un OptionalDouble : les appelants doivent donc gérer le cas d’un tableau vide au lieu de recevoir une moyenne numérique fabriquée.

Le code et les libellés ou sorties affichés dans cette section restent en anglais.

import java.util.OptionalDouble;

public class AverageCalculator {
    public static void main(String[] args) {
        int[] numbers = {10, 20, 30, 40, 50};
        OptionalDouble result = average(numbers);

        if (result.isPresent()) {
            System.out.println("Average: " + result.getAsDouble());
        } else {
            System.out.println("No average is defined for this input.");
        }
    }

    public static OptionalDouble average(int[] numbers) {
        if (numbers.length == 0) {
            return OptionalDouble.empty();
        }

        double sum = 0.0;
        for (int number : numbers) {
            sum += number;
        }
        return OptionalDouble.of(sum / numbers.length);
    }
}

La méthode accepte un tableau d’entiers et signale le cas sans valeur au moyen de son type de retour. Si votre application peut aussi recevoir null, décidez et documentez s’il faut le rejeter ou le traiter séparément ; cette méthode attend un tableau non nul.

Calculer une moyenne à partir d’une liste

Une liste d’entiers peut utiliser la même opération IntStream.average au moyen de List.stream(). Là encore, le résultat OptionalDouble distingue une moyenne calculée d’une liste vide.

Le code et les libellés ou sorties affichés dans cette section restent en anglais.

import java.util.Arrays;
import java.util.List;
import java.util.OptionalDouble;

public class AverageList {
    public static void main(String[] args) {
        List<Integer> numbers = Arrays.asList(10, 20, 30, 40, 50);
        OptionalDouble result = numbers.stream()
                .mapToInt(Integer::intValue)
                .average();

        if (result.isPresent()) {
            System.out.println("Average: " + result.getAsDouble());
        } else {
            System.out.println("No average is defined for this input.");
        }
    }
}

mapToInt convertit les éléments Integer encapsulés en IntStream, qui fournit average(). Pour les listes de valeurs Double, utilisez mapToDouble et vérifiez si la liste contient des éléments null avant de les désencapsuler.