Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Násobenie desatinných čísel metódou BigDecimal.multiply

Vynásobte dve hodnoty `BigDecimal` presne alebo zaokrúhlite súčin podľa presnosti a režimu zaokrúhľovania nastavených v `MathContext`.

Verzia: Java SE 21

Syntax

public BigDecimal multiply(BigDecimal multiplicand)
public BigDecimal multiply(BigDecimal multiplicand, MathContext mc)

V Java SE 21 je BigDecimal.multiply inštančná metóda triedy java.math.BigDecimal. Ak chcete vynásobiť dva objekty BigDecimal, napíšte a.multiply(b), nie a * b. Obe preťažené verzie vracajú súčin typu BigDecimal. Objekty sú nemenné: ani jeden operand sa nezmení. Ak výsledok budete potrebovať neskôr, uložte si vrátenú hodnotu.

Volanie a.multiply(b) vráti presný súčin. Preferovanou mierkou je súčet a.scale() a b.scale(). Výsledok má túto mierku, ak sa súčet zmestí do rozsahu typu int. Nezáporná mierka udáva počet číslic za desatinným oddeľovačom. Súčin 2.50 a 1.25 je teda 3.1250 s mierkou 4 vrátane koncovej nuly. Ak je súčet mimo rozsahu typu int, JDK 21 môže vrátiť nulu s mierkou nastavenou na najbližšiu hranicu tohto rozsahu. Ak je napríklad a nula s mierkou Integer.MAX_VALUE a b má mierku 1, volanie a.multiply(b) vráti nulu s mierkou Integer.MAX_VALUE.

Volanie a.multiply(b, mc) použije presnosť a režim zaokrúhľovania z MathContext. Kladná presnosť obmedzuje počet platných číslic výsledku, nie počet desatinných miest. Mierka výsledku sa preto môže líšiť od súčtu mierok operandov. Presnosť 0, napríklad v MathContext.UNLIMITED, znamená presný súčin bez použitia režimu zaokrúhľovania.

Argument null vyvolá výnimku NullPointerException. Ak sa výsledok pri požadovanej presnosti nedá vyjadriť presne, režim RoundingMode.UNNECESSARY vyvolá výnimku ArithmeticException. Táto výnimka môže nastať aj vtedy, keď je mierka potrebná pre výsledok mimo rozsahu typu int.

Prí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ýsledok

3.1250 (scale=4)
3.13 (scale=2)
2.50

Reťazce zadávajú desatinné hodnoty bez prevodu z typu `double`. Prvý riadok ukazuje presný súčin, druhý výsledok zaokrúhlený na tri platné číslice režimom `RoundingMode.HALF_UP` a tretí nezmenenú hodnotu `a`.

Súvisiace lekcie

  • Java · Lekcia 4 · Základná · Verzia: 2
  • Java · Lekcia 69 · Základná · Verzia: 2

Zdroje