CKTIS / Java
Integer.sum — zwei int-Werte addieren
`Integer.sum(a, b)` addiert zwei `int`-Werte wie der Operator `+`. Mit `Integer::sum` lässt sich die Addition als Funktion übergeben.
Version: Java SE 21
Syntax
public static int sum(int a, int b)
Integer.sum(a, b)
Integer::sumInteger.sum ist eine statische Methode von java.lang.Integer und seit Java 8 verfügbar. Sie erwartet genau zwei primitive int-Werte und gibt einen int zurück. In Texten kann Integer.sum() als Kurzschreibweise vorkommen. Als Aufruf lässt sich der Ausdruck aber nicht kompilieren, denn es gibt keine Überladung ohne Argumente. Verwende Integer.sum(a, b).
Für zwei int-Werte ergibt sich dasselbe Resultat wie bei a + b. Bei einem Überlauf springt das Ergebnis innerhalb des 32-Bit-int-Wertebereichs um, ohne eine Ausnahme auszulösen: Integer.sum(Integer.MAX_VALUE, 1) liefert Integer.MIN_VALUE. Wenn ein Überlauf eine ArithmeticException auslösen soll, verwende Math.addExact(a, b). Ein Argument vom Typ Integer wird automatisch entpackt; das Entpacken von null löst eine NullPointerException aus.
Integer::sum ist eine Methodenreferenz, kein Aufruf. Der Zieltyp, etwa IntBinaryOperator, bestimmt, wie sie verwendet werden kann. Der Aufruf add.applyAsInt(20, 22) führt die Addition aus und liefert 42. Die Methode selbst ändert keinen Zustand und aktualisiert kein AtomicInteger-Objekt.
In einer Map<String, Integer> speichert merge(key, value, Integer::sum) die Summe aus dem vorhandenen, nicht null lautenden Wert und dem neuen Wert. Fehlt der Schlüssel oder ist ihm null zugeordnet, wird der neue Wert ohne Funktionsaufruf gespeichert; der neue Wert darf nicht null sein. Bei einem Stream<Integer> verwendet reduce(0, Integer::sum, Integer::sum) die 0 als neutrales Element: Die erste Referenz addiert das nächste Element zum bisherigen Ergebnis, die zweite führt Teilergebnisse zusammen.
Beispiele
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));
}
}Ergebnis
42 42 42 42 -2147483648
Die ersten vier Zeilen zeigen einen direkten Aufruf, eine Methodenreferenz, das Zusammenführen von Werten in einer Map und eine Stream-Reduktion. Die letzte Zeile zeigt den Überlauf.
Zugehörige Lektionen
- Java · Lektion 41 · Fortgeschritten · Version: 2
- Java · Lektion 56 · Grundlagen · Version: 2
- Java · Lektion 65 · Grundlagen · Version: 2
- Java · Lektion 66 · Grundlagen · Version: 2
- Java · Lektion 39 · Mittlere Stufe · Version: 2
- Java · Lektion 56 · Mittlere Stufe · Version: 2
- Java · Lektion 57 · Mittlere Stufe · Version: 2
Quellen
- Java SE 21 API — Integer.sum(int, int)
- Java Language Specification, Java SE 21 — §15.13 Method Reference Expressions
- Java Language Specification, Java SE 21 — §15.18.2 Additive Operators (+ and -) for Numeric Types
- Java Language Specification, Java SE 21 — §5.1.8 Unboxing Conversion
- Java SE 21 API — Math.addExact(int, int)
- Java SE 21 API — IntBinaryOperator
- Java SE 21 API — Map.merge
- Java SE 21 API — Stream.reduce with identity, accumulator, and combiner