CKTIS / Java
Decimale getallen vermenigvuldigen met BigDecimal.multiply
Vermenigvuldig twee `BigDecimal`-waarden exact of rond het product af met de precisie en afrondingsmodus van een `MathContext`.
Versie: Java SE 21
Syntax
public BigDecimal multiply(BigDecimal multiplicand)
public BigDecimal multiply(BigDecimal multiplicand, MathContext mc)In Java SE 21 is BigDecimal.multiply een instantiemethode van java.math.BigDecimal. Schrijf a.multiply(b) om twee BigDecimal-objecten te vermenigvuldigen, niet a * b. Beide varianten geven het product terug als BigDecimal. De objecten zijn onveranderlijk: geen van beide operanden verandert. Bewaar de teruggegeven waarde als je die later nodig hebt.
a.multiply(b) geeft het exacte product terug. De voorkeursschaal is de som van a.scale() en b.scale(). Het resultaat heeft die schaal als de som in een int past. Als de schaal niet negatief is, geeft die het aantal cijfers na het decimaalteken aan. Zo geeft 2.50 maal 1.25 het resultaat 3.1250 met schaal 4, inclusief de laatste nul. Valt de som buiten het bereik van int, dan kan JDK 21 nul teruggeven met de schaal op de dichtstbijzijnde grens van dat bereik. Als a bijvoorbeeld nul is met schaal Integer.MAX_VALUE en b schaal 1 heeft, geeft a.multiply(b) nul terug met schaal Integer.MAX_VALUE.
a.multiply(b, mc) gebruikt de precisie en afrondingsmodus van de MathContext. Een positieve precisie beperkt het aantal significante cijfers in het resultaat, niet het aantal decimalen. De schaal van het resultaat kan daardoor afwijken van de som van de schalen van de operanden. Precisie 0, zoals bij MathContext.UNLIMITED, vraagt om een exact product en negeert de afrondingsmodus.
Een argument met de waarde null veroorzaakt een NullPointerException. Als het resultaat met de gevraagde precisie niet exact kan zijn, veroorzaakt RoundingMode.UNNECESSARY een ArithmeticException. Die uitzondering kan ook optreden als de schaal die voor het resultaat nodig is buiten het bereik van int valt.
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("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());
}
}Resultaat
3.1250 (scale=4) 3.13 (scale=2) 2.50
De tekenreeksen leveren de decimale waarden zonder conversie vanuit `double`. De eerste regel toont het exacte product, de tweede het met `RoundingMode.HALF_UP` op drie significante cijfers afgeronde resultaat en de derde de onveranderde waarde van `a`.
Gerelateerde lessen
- Java · Les 4 · Basis · Versie: 2
- Java · Les 69 · Basis · Versie: 2