CKTIS / Java
Násobení desetinných čísel metodou BigDecimal.multiply
Vynásobte dvě hodnoty `BigDecimal` přesně nebo zaokrouhlete součin podle přesnosti a režimu zaokrouhlování nastavených v `MathContext`.
Verze: Java SE 21
Syntaxe
public BigDecimal multiply(BigDecimal multiplicand)
public BigDecimal multiply(BigDecimal multiplicand, MathContext mc)V Java SE 21 je BigDecimal.multiply instanční metoda třídy java.math.BigDecimal. Chcete-li vynásobit dva objekty BigDecimal, napište a.multiply(b), nikoli a * b. Obě přetížené varianty vracejí součin typu BigDecimal. Objekty jsou neměnné: ani jeden operand se nezmění. Pokud výsledek budete potřebovat později, uložte si vrácenou hodnotu.
Volání a.multiply(b) vrátí přesný součin. Preferovaným měřítkem je součet a.scale() a b.scale(). Výsledek má toto měřítko, pokud se součet vejde do rozsahu typu int. Nezáporné měřítko udává počet číslic za desetinným oddělovačem. Součinem 2.50 a 1.25 je tedy 3.1250 s měřítkem 4, včetně koncové nuly. Pokud je součet mimo rozsah typu int, může JDK 21 vrátit nulu s měřítkem nastaveným na nejbližší mez tohoto rozsahu. Pokud je například a nula s měřítkem Integer.MAX_VALUE a b má měřítko 1, volání a.multiply(b) vrátí nulu s měřítkem Integer.MAX_VALUE.
Volání a.multiply(b, mc) použije přesnost a režim zaokrouhlování z MathContext. Kladná přesnost omezuje počet platných číslic výsledku, nikoli počet desetinných míst. Měřítko výsledku se proto může lišit od součtu měřítek operandů. Přesnost 0, například v MathContext.UNLIMITED, požaduje přesný součin a režim zaokrouhlování se nepoužije.
Předání null jako argumentu vyvolá výjimku NullPointerException. Pokud při požadované přesnosti nelze výsledek vyjádřit přesně, režim RoundingMode.UNNECESSARY vyvolá výjimku ArithmeticException. Tato výjimka může nastat i tehdy, když je měřítko potřebné pro výsledek mimo rozsah typu int.
Příklady
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());
}
}Výsledek
3.1250 (scale=4) 3.13 (scale=2) 2.50
Řetězce zadávají desetinné hodnoty bez převodu z typu `double`. První řádek ukazuje přesný součin, druhý výsledek zaokrouhlený na tři platné číslice režimem `RoundingMode.HALF_UP` a třetí nezměněnou hodnotu `a`.
Související lekce
- Java · Lekce 4 · Základní · Verze: 2
- Java · Lekce 69 · Základní · Verze: 2