CKTIS / Java
Dezimalzahlen mit BigDecimal.multiply multiplizieren
Multipliziere zwei `BigDecimal`-Werte exakt oder runde das Produkt nach der in einem `MathContext` festgelegten Präzision und Rundungsart.
Version: Java SE 21
Syntax
public BigDecimal multiply(BigDecimal multiplicand)
public BigDecimal multiply(BigDecimal multiplicand, MathContext mc)In Java SE 21 ist BigDecimal.multiply eine Instanzmethode von java.math.BigDecimal. Um zwei BigDecimal-Objekte zu multiplizieren, schreibe a.multiply(b) statt a * b. Beide Überladungen geben das Produkt als BigDecimal zurück. Die Objekte sind unveränderlich: Keiner der Operanden ändert sich. Speichere daher den Rückgabewert, wenn du ihn später brauchst.
a.multiply(b) liefert das exakte Produkt. Die bevorzugte Skala ist die Summe von a.scale() und b.scale(). Das Ergebnis hat diese Skala, wenn die Summe im Wertebereich von int liegt. Ist die Skala nicht negativ, gibt sie die Anzahl der Nachkommastellen an. Daher ergibt 2.50 mal 1.25 den Wert 3.1250 mit Skala 4, einschließlich der abschließenden Null. Liegt die Summe außerhalb des Wertebereichs von int, kann JDK 21 null zurückgeben und die Skala auf die nächstgelegene Grenze dieses Bereichs setzen. Ist a zum Beispiel null mit Skala Integer.MAX_VALUE und hat b die Skala 1, liefert a.multiply(b) null mit Skala Integer.MAX_VALUE.
a.multiply(b, mc) verwendet Präzision und Rundungsmodus aus dem MathContext. Eine positive Präzision begrenzt die Anzahl der signifikanten Stellen im Ergebnis, nicht die Anzahl der Nachkommastellen. Die Ergebnisskala kann daher von der Summe der Skalen der Operanden abweichen. Die Präzision 0, etwa bei MathContext.UNLIMITED, verlangt ein exaktes Produkt und ignoriert den Rundungsmodus.
Ein Argument mit dem Wert null löst eine NullPointerException aus. Wäre das Ergebnis bei der gewählten Präzision ungenau, löst RoundingMode.UNNECESSARY eine ArithmeticException aus. Diese Ausnahme kann auch auftreten, wenn die für das Ergebnis benötigte Skala außerhalb des Wertebereichs von int liegt.
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("2.50");
BigDecimal b = new BigDecimal("1.25");
BigDecimal exact = a.multiply(b);
BigDecimal rounded = a.multiply(b, new MathContext(3, RoundingMode.HALF_UP));
System.out.println(exact.toPlainString() + " (scale=" + exact.scale() + ")");
System.out.println(rounded.toPlainString() + " (scale=" + rounded.scale() + ")");
System.out.println(a.toPlainString());
}
}Ergebnis
3.1250 (scale=4) 3.13 (scale=2) 2.50
Die Zeichenketten liefern Dezimalwerte ohne Umwandlung aus `double`. Die erste Zeile zeigt das exakte Produkt, die zweite das mit `RoundingMode.HALF_UP` auf drei signifikante Stellen gerundete Ergebnis und die dritte den unveränderten Wert von `a`.
Zugehörige Lektionen
- Java · Lektion 4 · Grundlagen · Version: 2
- Java · Lektion 69 · Grundlagen · Version: 2