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

CKTIS / Java

Integer.sum — additionner deux valeurs int

`Integer.sum(a, b)` additionne deux valeurs `int` comme l’opérateur `+`. La syntaxe `Integer::sum` permet de passer l’addition comme fonction.

Version : Java SE 21

Syntaxe

public static int sum(int a, int b)
Integer.sum(a, b)
Integer::sum

Integer.sum est une méthode statique de java.lang.Integer, disponible depuis Java 8. Elle prend exactement deux valeurs primitives int et renvoie un int. Dans un texte, Integer.sum() peut servir de notation abrégée, mais cet appel ne compile pas : il n’existe pas de surcharge sans argument. Utilisez Integer.sum(a, b).

Pour deux valeurs int, le résultat est identique à a + b. En cas de dépassement, le résultat revient dans la plage des int sur 32 bits sans lever d’exception : Integer.sum(Integer.MAX_VALUE, 1) renvoie Integer.MIN_VALUE. Pour lever une ArithmeticException en cas de dépassement, utilisez Math.addExact(a, b). Un argument de type Integer est automatiquement déballé en int ; le déballage de null lève une NullPointerException.

Integer::sum est une référence de méthode, pas un appel. Le type cible, par exemple IntBinaryOperator, détermine comment l’utiliser. L’appel add.applyAsInt(20, 22) effectue l’addition et renvoie 42. La méthode ne modifie aucun état et ne met pas à jour un objet AtomicInteger.

Dans une Map<String, Integer>, merge(key, value, Integer::sum) enregistre la somme de la valeur existante non nulle et de la nouvelle valeur. Si la clé est absente ou associée à null, la nouvelle valeur est enregistrée sans appeler la fonction ; elle ne doit pas être null. Sur un Stream<Integer>, reduce(0, Integer::sum, Integer::sum) utilise 0 comme élément neutre : la première référence ajoute l’élément suivant au résultat courant et la seconde combine les résultats partiels.

Exemples

import java.util.HashMap;
import java.util.Map;
import java.util.function.IntBinaryOperator;
import java.util.stream.Stream;

public class IntegerSumDemo {
    public static void main(String[] args) {
        System.out.println(Integer.sum(20, 22));

        IntBinaryOperator add = Integer::sum;
        System.out.println(add.applyAsInt(20, 22));

        Map<String, Integer> totals = new HashMap<>();
        totals.put("points", 20);
        System.out.println(totals.merge("points", 22, Integer::sum));

        int total = Stream.of(10, 12, 20)
                .reduce(0, Integer::sum, Integer::sum);
        System.out.println(total);

        System.out.println(Integer.sum(Integer.MAX_VALUE, 1));
    }
}

Résultat

42
42
42
42
-2147483648

Les quatre premières lignes montrent, dans l’ordre, un appel direct, une référence de méthode, une fusion de valeurs dans une map et une réduction de flux. La dernière ligne montre le dépassement.

Leçons associées

  • Java · Leçon 41 · Avancé · Version : 2
  • Java · Leçon 56 · Débutant · Version : 2
  • Java · Leçon 65 · Débutant · Version : 2
  • Java · Leçon 66 · Débutant · Version : 2
  • Java · Leçon 39 · Intermédiaire · Version : 2
  • Java · Leçon 56 · Intermédiaire · Version : 2
  • Java · Leçon 57 · Intermédiaire · Version : 2

Sources