KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

BigDecimal.subtract — decimale waarden aftrekken

Trek twee `BigDecimal`-waarden exact van elkaar af of rond het verschil af volgens een `MathContext`. Beide operanden blijven ongewijzigd.

Versie: Java SE 21

Syntax

public BigDecimal subtract(BigDecimal subtrahend)
public BigDecimal subtract(BigDecimal subtrahend, MathContext mc)

BigDecimal.subtract is een instantiemethode van java.math.BigDecimal. De aanroep a.subtract(b) berekent a − b: het argument wordt afgetrokken van het object waarop je de methode aanroept. De volgorde is belangrijk. De operator - werkt niet op BigDecimal-objecten.

subtract(BigDecimal) geeft het exacte verschil terug zonder afronding. De schaal is Math.max(a.scale(), b.scale()). Een niet-negatieve schaal telt de cijfers achter het decimaalteken, inclusief eventuele nullen aan het einde. BigDecimal is onveranderlijk, dus beide operanden blijven gelijk. Bewaar de teruggegeven waarde als je het verschil later nodig hebt.

subtract(BigDecimal, MathContext) rondt het exacte verschil zo nodig af volgens de precisie en afrondingsmodus van de context. Precisie telt significante cijfers, geen decimalen. Precisie 0, zoals bij MathContext.UNLIMITED, betekent exact rekenen zonder afronding. Als afronding nodig is maar de modus RoundingMode.UNNECESSARY is, gooit de methode een ArithmeticException. Geef je null mee als af te trekken waarde of als context, dan volgt een NullPointerException.

Voorbeelden

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());
    }
}

Resultaat

11.844
3
11.8
12.30
0.456

De constructors die tekenreeksen aannemen behouden de exacte decimale waarden zonder conversie via `double`. Het programma toont het exacte verschil `11.844`, de schaal `3`, de met `HALF_UP` op drie significante cijfers afgeronde uitkomst `11.8` en tot slot de ongewijzigde operanden `12.30` en `0.456`.

Gerelateerde lessen

  • Java · Les 69 · Basis · Versie: 2

Bronnen