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

CKTIS / Java

Multiplicar números decimais com BigDecimal.multiply

Multiplica dois valores `BigDecimal` de forma exata ou arredonda o produto segundo a precisão e o modo de arredondamento de um `MathContext`.

Versão: Java SE 21

Sintaxe

public BigDecimal multiply(BigDecimal multiplicand)
public BigDecimal multiply(BigDecimal multiplicand, MathContext mc)

Em Java SE 21, BigDecimal.multiply é um método de instância de java.math.BigDecimal. Para multiplicar dois objetos BigDecimal, escreve a.multiply(b), não a * b. As duas sobrecargas devolvem o produto como BigDecimal. Os objetos são imutáveis: nenhum dos operandos muda. Guarda o valor devolvido se precisares dele mais tarde.

a.multiply(b) devolve o produto exato. A escala preferida é a soma de a.scale() e b.scale(). O resultado usa essa escala se a soma couber num int. Se a escala não for negativa, indica o número de algarismos à direita do separador decimal. Assim, 2.50 vezes 1.25 dá 3.1250, com escala 4, incluindo o zero final. Se a soma estiver fora do intervalo do tipo int, o JDK 21 pode devolver zero com a escala fixada no limite mais próximo desse intervalo. Por exemplo, se a for zero com escala Integer.MAX_VALUE e b tiver escala 1, a.multiply(b) devolve zero com escala Integer.MAX_VALUE.

a.multiply(b, mc) usa a precisão e o modo de arredondamento do MathContext. Uma precisão positiva limita o número de algarismos significativos do resultado, não o número de casas decimais. Por isso, a escala do resultado pode ser diferente da soma das escalas dos operandos. Uma precisão de 0, como em MathContext.UNLIMITED, pede um produto exato e ignora o modo de arredondamento.

Passar null como argumento lança uma NullPointerException. Se o resultado não puder ser exato com a precisão pedida, RoundingMode.UNNECESSARY lança uma ArithmeticException. Esta exceção também pode ocorrer se a escala necessária para o resultado estiver fora do intervalo do tipo int.

Exemplos

import java.math.BigDecimal;
import java.math.MathContext;
import java.math.RoundingMode;

public class Main {
    public static void main(String[] args) {
        BigDecimal a = new BigDecimal("2.50");
        BigDecimal b = new BigDecimal("1.25");

        BigDecimal exact = a.multiply(b);
        BigDecimal rounded = a.multiply(b, new MathContext(3, RoundingMode.HALF_UP));

        System.out.println(exact.toPlainString() + " (scale=" + exact.scale() + ")");
        System.out.println(rounded.toPlainString() + " (scale=" + rounded.scale() + ")");
        System.out.println(a.toPlainString());
    }
}

Resultado

3.1250 (scale=4)
3.13 (scale=2)
2.50

As cadeias de caracteres fornecem os valores decimais sem conversão a partir de `double`. A primeira linha mostra o produto exato, a segunda o resultado arredondado a três algarismos significativos com `RoundingMode.HALF_UP` e a terceira o valor inalterado de `a`.

Lições relacionadas

  • Java · Lição 4 · Básico · Versão: 2
  • Java · Lição 69 · Básico · Versão: 2

Fontes