CKTIS / Java
BigDecimal.add — exakte und gerundete Addition
Addiere BigDecimal-Werte exakt oder lege mit MathContext die Genauigkeit und den Rundungsmodus für das Ergebnis fest.
Version: 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 ist eine Instanzmethode von java.math.BigDecimal. Bei a.add(b) sind das Objekt a und das Argument b die beiden Summanden. Zwei BigDecimal-Objekte lassen sich nicht mit + addieren. Sie sind unveränderlich: Die Methode gibt das Ergebnis zurück, ohne einen Summanden zu ändern. Speichere oder verwende den Rückgabewert; a.add(b); allein ändert a nicht.
a.add(b) liefert die exakte Summe mit der Skalierung max(a.scale(), b.scale()). Eine nichtnegative Skalierung gibt die Anzahl der Nachkommastellen einschließlich abschließender Nullen an. Sie kann auch negativ sein: Bei -2 ist der Wert die gespeicherte ganze Zahl mal 100.
a.add(b, mc) erwartet einen MathContext aus java.math. Eine positive Genauigkeit begrenzt die Anzahl signifikanter Stellen im Ergebnis, nicht die Anzahl der Nachkommastellen. Die Methode rundet die exakte Summe bei Bedarf nach dem angegebenen Rundungsmodus; dabei kann sich die Skalierung ändern. Ist bei positiver Genauigkeit genau ein Summand null, entspricht der Zahlenwert des Ergebnisses dem des von null verschiedenen Summanden, gegebenenfalls gerundet. Die Skalierung des Ergebnisses kann auch ohne Rundung von der Skalierung dieses Summanden abweichen. Addiert man etwa bei einer Genauigkeit von 3 den Wert 0.00 zu 1, erhält man 1.00. Die Genauigkeit 0, wie bei MathContext.UNLIMITED, bedeutet Addition ohne Rundung.
Würde das Runden den Wert ändern, löst RoundingMode.UNNECESSARY eine ArithmeticException aus. Wird null als b oder mc übergeben, wird eine NullPointerException ausgelöst.
Beispiele
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());
}
}Ergebnis
12.750 12.8 12.40
Die Summanden werden aus Zeichenketten erzeugt, um eine vorherige Umwandlung in `double` zu vermeiden. Die exakte Summe `12.750` hat die Skalierung 3; bei drei signifikanten Stellen ergibt `HALF_UP` den Wert `12.8`. Die letzte Zeile zeigt, dass `a` weiterhin den Wert `12.40` hat.
Zugehörige Lektionen
- Java · Lektion 4 · Grundlagen · Version: 2
- Java · Lektion 69 · Grundlagen · Version: 2