CKTIS / Java
Integer.sum — dodawanie dwóch wartości int
Metoda `Integer.sum(a, b)` dodaje dwie wartości `int` tak jak operator `+`. Zapis `Integer::sum` pozwala przekazać dodawanie jako funkcję.
Wersja: Java SE 21
Składnia
public static int sum(int a, int b)
Integer.sum(a, b)
Integer::sumInteger.sum to metoda statyczna klasy java.lang.Integer, dostępna od Javy 8. Przyjmuje dokładnie dwie wartości typu pierwotnego int i zwraca int. Zapis Integer.sum() może oznaczać nazwę metody w tekście, ale jako wywołanie nie skompiluje się: nie ma wersji bez argumentów. Wywołaj Integer.sum(a, b).
Dla dwóch wartości int wynik jest taki sam jak dla a + b. Przy przepełnieniu wynik zawija się w zakresie 32-bitowego int, bez wyjątku: Integer.sum(Integer.MAX_VALUE, 1) zwraca Integer.MIN_VALUE. Jeśli przepełnienie ma zgłosić ArithmeticException, użyj Math.addExact(a, b). Argument typu Integer jest automatycznie rozpakowywany; jeśli ma wartość null, rozpakowanie zgłasza NullPointerException.
Integer::sum to referencja do metody, a nie jej wywołanie. Typ docelowy, na przykład IntBinaryOperator, określa, jak można jej użyć. Wywołanie add.applyAsInt(20, 22) wykonuje dodawanie i zwraca 42. Sama metoda nie zmienia żadnego stanu i nie aktualizuje obiektu AtomicInteger.
W Map<String, Integer> wywołanie merge(key, value, Integer::sum) zapisuje sumę dotychczasowej wartości różnej od null i nowej wartości. Jeśli klucz nie istnieje lub ma wartość null, zapisuje nową wartość bez wywoływania funkcji; przekazana nowa wartość nie może być null. W Stream<Integer> wyrażenie reduce(0, Integer::sum, Integer::sum) używa 0 jako elementu neutralnego: pierwsza referencja dodaje kolejny element do wyniku, a druga łączy wyniki częściowe.
Przykłady
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));
}
}Wynik
42 42 42 42 -2147483648
Pierwsze cztery wiersze pokazują kolejno wywołanie bezpośrednie, użycie referencji, scalenie wartości w mapie i redukcję strumienia. Ostatni wiersz pokazuje przepełnienie.
Powiązane lekcje
- Java · Lekcja 41 · Zaawansowany · Wersja: 2
- Java · Lekcja 56 · Podstawowy · Wersja: 2
- Java · Lekcja 65 · Podstawowy · Wersja: 2
- Java · Lekcja 66 · Podstawowy · Wersja: 2
- Java · Lekcja 39 · Średniozaawansowany · Wersja: 2
- Java · Lekcja 56 · Średniozaawansowany · Wersja: 2
- Java · Lekcja 57 · Średniozaawansowany · Wersja: 2
Źródła
- 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