CKTIS / Java
Integer.sum — somar dois valores int
`Integer.sum(a, b)` soma dois valores `int` tal como o operador `+`. Com `Integer::sum`, podes passar a adição como função.
Versão: Java SE 21
Sintaxe
public static int sum(int a, int b)
Integer.sum(a, b)
Integer::sumInteger.sum é um método estático de java.lang.Integer, disponível desde o Java 8. Recebe exatamente dois valores primitivos int e devolve um int. Num texto, Integer.sum() pode servir de abreviatura, mas não compila como chamada: não existe uma sobrecarga sem argumentos. Usa Integer.sum(a, b).
Para dois valores int, o resultado é igual ao de a + b. Em caso de transbordo, o resultado volta ao intervalo de int de 32 bits sem lançar uma exceção: Integer.sum(Integer.MAX_VALUE, 1) devolve Integer.MIN_VALUE. Usa Math.addExact(a, b) se quiseres que o transbordo lance ArithmeticException. Um argumento do tipo Integer é automaticamente convertido em int por unboxing; fazer unboxing de null lança NullPointerException.
Integer::sum é uma referência a um método, não uma chamada. O tipo de destino, como IntBinaryOperator, determina como podes utilizá-la. A chamada add.applyAsInt(20, 22) executa a adição e devolve 42. O método não altera nenhum estado nem atualiza um objeto AtomicInteger.
Num Map<String, Integer>, merge(key, value, Integer::sum) guarda a soma do valor existente diferente de null e do novo valor. Se a chave não existir ou estiver associada a null, guarda o novo valor sem chamar a função; o novo valor não pode ser null. Num Stream<Integer>, reduce(0, Integer::sum, Integer::sum) usa 0 como elemento neutro: a primeira referência adiciona o elemento seguinte ao resultado acumulado e a segunda combina os resultados parciais.
Exemplos
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
As primeiras quatro linhas mostram, por ordem, uma chamada direta, uma referência a um método, a combinação de valores num mapa e uma redução de um stream. A última linha mostra o transbordo.
Lições relacionadas
- Java · Lição 41 · Avançado · Versão: 2
- Java · Lição 56 · Básico · Versão: 2
- Java · Lição 65 · Básico · Versão: 2
- Java · Lição 66 · Básico · Versão: 2
- Java · Lição 39 · Intermédio · Versão: 2
- Java · Lição 56 · Intermédio · Versão: 2
- Java · Lição 57 · Intermédio · Versão: 2
Fontes
- 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