CKTIS / Java
Integer.sum — sumar dos valores int
`Integer.sum(a, b)` suma dos valores `int` igual que el operador `+`. Con `Integer::sum` puedes pasar la suma como función.
Versión: Java SE 21
Sintaxis
public static int sum(int a, int b)
Integer.sum(a, b)
Integer::sumInteger.sum es un método estático de java.lang.Integer, disponible desde Java 8. Recibe exactamente dos valores primitivos int y devuelve un int. En un texto, Integer.sum() puede usarse como abreviatura, pero como llamada no compila: no hay una sobrecarga sin argumentos. Usa Integer.sum(a, b).
Para dos valores int, el resultado es el mismo que el de a + b. Si hay desbordamiento, el resultado vuelve al rango de int de 32 bits sin lanzar una excepción: Integer.sum(Integer.MAX_VALUE, 1) devuelve Integer.MIN_VALUE. Usa Math.addExact(a, b) si quieres que el desbordamiento lance ArithmeticException. Un argumento Integer se desempaqueta automáticamente; desempaquetar null lanza NullPointerException.
Integer::sum es una referencia a un método, no una llamada. El tipo de destino, por ejemplo IntBinaryOperator, determina cómo se puede usar. Al llamar a add.applyAsInt(20, 22), se realiza la suma y se obtiene 42. El método no modifica ningún estado ni actualiza un objeto AtomicInteger.
En un Map<String, Integer>, merge(key, value, Integer::sum) guarda la suma del valor existente distinto de null y el valor nuevo. Si la clave no existe o está asociada a null, guarda el valor nuevo sin llamar a la función; el valor nuevo no puede ser null. En un Stream<Integer>, reduce(0, Integer::sum, Integer::sum) usa 0 como elemento neutro: la primera referencia suma el siguiente elemento al resultado acumulado y la segunda combina resultados parciales.
Ejemplos
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));
}
}Resultado
42 42 42 42 -2147483648
Las primeras cuatro líneas muestran, en orden, una llamada directa, una referencia a un método, una fusión de valores en un mapa y una reducción de flujo. La última línea muestra el desbordamiento.
Lecciones relacionadas
- Java · Lección 41 · Avanzado · Versión: 2
- Java · Lección 56 · Básico · Versión: 2
- Java · Lección 65 · Básico · Versión: 2
- Java · Lección 66 · Básico · Versión: 2
- Java · Lección 39 · Intermedio · Versión: 2
- Java · Lección 56 · Intermedio · Versión: 2
- Java · Lección 57 · Intermedio · Versión: 2
Fuentes
- 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