KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

BigDecimal.add — exact of afgerond optellen

Tel BigDecimal-waarden exact op of stel met MathContext de precisie en afrondingsmodus van het resultaat in.

Versie: Java SE 21

Syntax

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

BigDecimal exact = a.add(b);
BigDecimal rounded = a.add(b, mc);

// Instance method signatures in java.math.BigDecimal:
// public BigDecimal add(BigDecimal augend)
// public BigDecimal add(BigDecimal augend, MathContext mc)

BigDecimal.add is een instantiemethode van java.math.BigDecimal. Bij a.add(b) zijn het object a en het argument b de twee termen. Je kunt twee BigDecimal-objecten niet optellen met +. Deze objecten zijn onveranderlijk: de methode retourneert het resultaat zonder de termen te wijzigen. Bewaar of gebruik de retourwaarde; a.add(b); op zichzelf werkt a niet bij.

a.add(b) geeft de exacte som met schaal max(a.scale(), b.scale()). Een niet-negatieve schaal geeft het aantal decimalen aan, inclusief nullen aan het eind. De schaal kan ook negatief zijn: bij schaal -2 is de waarde het opgeslagen gehele getal maal 100.

a.add(b, mc) neemt een MathContext uit java.math aan. Een positieve precisie beperkt het aantal significante cijfers van het resultaat, niet het aantal decimalen. De methode rondt de exacte som zo nodig af volgens de opgegeven afrondingsmodus; de schaal kan daardoor veranderen. Als bij een positieve precisie precies één term nul is, heeft het resultaat de numerieke waarde van de term die niet nul is, zo nodig afgerond. De schaal van het resultaat kan ook zonder afronding afwijken van die van die term. Als je bijvoorbeeld bij precisie 3 de waarde 0.00 bij 1 optelt, krijg je 1.00. Precisie 0, zoals bij MathContext.UNLIMITED, betekent optellen zonder afronding.

Als afronding de waarde zou veranderen, leidt RoundingMode.UNNECESSARY tot een ArithmeticException. Geef je null mee als b of mc, 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.40");
        BigDecimal b = new BigDecimal("0.350");
        MathContext mc = new MathContext(3, RoundingMode.HALF_UP);

        BigDecimal exact = a.add(b);
        BigDecimal rounded = a.add(b, mc);

        System.out.println(exact.toPlainString());
        System.out.println(rounded.toPlainString());
        System.out.println(a.toPlainString());
    }
}

Resultaat

12.750
12.8
12.40

De termen worden opgebouwd uit tekenreeksen om een voorafgaande omzetting naar `double` te vermijden. De exacte som `12.750` heeft schaal 3; bij drie significante cijfers geeft `HALF_UP` de waarde `12.8`. De laatste regel laat zien dat `a` nog steeds `12.40` is.

Gerelateerde lessen

  • Java · Les 4 · Basis · Versie: 2
  • Java · Les 69 · Basis · Versie: 2

Bronnen