Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Množenje decimalnih brojeva metodom BigDecimal.multiply

Pomnožite dvije vrijednosti `BigDecimal` točno ili zaokružite umnožak prema preciznosti i načinu zaokruživanja zadanima u `MathContext`.

Verzija: Java SE 21

Sintaksa

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

U izdanju Java SE 21 BigDecimal.multiply je instancijska metoda klase java.math.BigDecimal. Za množenje dvaju objekata BigDecimal napišite a.multiply(b), a ne a * b. Obje preopterećene inačice metode vraćaju umnožak tipa BigDecimal. Objekti su nepromjenjivi: nijedan se operand ne mijenja. Spremite vraćenu vrijednost ako ćete je poslije trebati.

Poziv a.multiply(b) vraća točan umnožak. Preferirana ljestvica jest zbroj vrijednosti a.scale() i b.scale(). Rezultat ima tu ljestvicu ako je zbroj u rasponu tipa int. Nenegativna ljestvica označava broj znamenaka iza decimalnog razdjelnika. Zato 2.50 puta 1.25 daje 3.1250 s ljestvicom 4, uključujući završnu nulu. Ako je zbroj izvan raspona tipa int, JDK 21 može vratiti nulu s ljestvicom postavljenom na najbližu granicu tog raspona. Primjerice, ako je a nula s ljestvicom Integer.MAX_VALUE, a b ima ljestvicu 1, poziv a.multiply(b) vraća nulu s ljestvicom Integer.MAX_VALUE.

Poziv a.multiply(b, mc) primjenjuje preciznost i način zaokruživanja iz MathContext. Pozitivna preciznost ograničava broj značajnih znamenaka rezultata, a ne broj decimalnih mjesta. Ljestvica rezultata stoga se može razlikovati od zbroja ljestvica operanada. Preciznost 0, primjerice u MathContext.UNLIMITED, traži točan umnožak i zanemaruje način zaokruživanja.

Ako proslijedite null kao argument, nastaje iznimka NullPointerException. Ako se pri zadanoj preciznosti rezultat ne može prikazati točno, RoundingMode.UNNECESSARY izaziva iznimku ArithmeticException. Ta iznimka može nastati i kad je ljestvica potrebna za rezultat izvan raspona tipa int.

Primjeri

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());
    }
}

Rezultat

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

Znakovni nizovi zadaju decimalne vrijednosti bez pretvorbe iz tipa `double`. Prvi redak prikazuje točan umnožak, drugi rezultat zaokružen na tri značajne znamenke načinom `RoundingMode.HALF_UP`, a treći nepromijenjenu vrijednost `a`.

Povezane lekcije

  • Java · Lekcija 4 · Osnovno · Verzija: 2
  • Java · Lekcija 69 · Osnovno · Verzija: 2

Izvori