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

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

Fontes