Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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::sum

Integer.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