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