Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje