CKTIS / Java
BigDecimal.subtract — subtrair valores decimais
Subtrai dois valores `BigDecimal` de forma exata ou arredonda a diferença de acordo com um `MathContext`. Nenhum dos operandos é alterado.
Versão: Java SE 21
Sintaxe
public BigDecimal subtract(BigDecimal subtrahend)
public BigDecimal subtract(BigDecimal subtrahend, MathContext mc)BigDecimal.subtract é um método de instância de java.math.BigDecimal. A chamada a.subtract(b) calcula a − b: subtrai o argumento ao objeto sobre o qual o método é invocado. A ordem importa. O operador - não se aplica a objetos BigDecimal.
subtract(BigDecimal) devolve a diferença exata, sem arredondamento, com uma escala igual a Math.max(a.scale(), b.scale()). Uma escala não negativa indica o número de algarismos depois do separador decimal, incluindo os zeros finais. BigDecimal é imutável, pelo que nenhum dos operandos é alterado. Guarda o valor devolvido se precisares da diferença mais tarde.
subtract(BigDecimal, MathContext) arredonda a diferença exata se necessário, de acordo com a precisão e o modo de arredondamento do contexto. A precisão conta algarismos significativos, não casas decimais. Uma precisão de 0, como em MathContext.UNLIMITED, indica um cálculo exato sem arredondamento. Se for necessário arredondar e o modo for RoundingMode.UNNECESSARY, o método lança ArithmeticException. Passar null como valor a subtrair ou como contexto provoca NullPointerException.
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("12.30");
BigDecimal b = new BigDecimal("0.456");
BigDecimal exact = a.subtract(b);
BigDecimal rounded = a.subtract(b, new MathContext(3, RoundingMode.HALF_UP));
System.out.println(exact.toPlainString());
System.out.println(exact.scale());
System.out.println(rounded.toPlainString());
System.out.println(a.toPlainString());
System.out.println(b.toPlainString());
}
}Resultado
11.844 3 11.8 12.30 0.456
Os construtores que recebem cadeias de caracteres preservam os valores decimais exatos sem recorrer a `double`. O programa mostra a diferença exata `11.844`, a sua escala `3`, o resultado `11.8` arredondado a três algarismos significativos com `HALF_UP` e, por fim, os operandos inalterados `12.30` e `0.456`.
Lições relacionadas
- Java · Lição 69 · Básico · Versão: 2