Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Mnożenie liczb dziesiętnych za pomocą BigDecimal.multiply

Pomnóż dwie wartości `BigDecimal` dokładnie albo zaokrąglij iloczyn zgodnie z precyzją i trybem zaokrąglania określonymi w `MathContext`.

Wersja: Java SE 21

Składnia

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

W Java SE 21 BigDecimal.multiply to metoda instancji klasy java.math.BigDecimal. Aby pomnożyć dwa obiekty BigDecimal, napisz a.multiply(b), a nie a * b. Oba przeciążenia zwracają iloczyn jako BigDecimal. Obiekty BigDecimal są niemutowalne: żaden z operandów się nie zmienia, więc zachowaj zwrócony wynik, jeśli chcesz go użyć później.

Wywołanie a.multiply(b) zwraca dokładny iloczyn. Preferowana skala to suma a.scale() i b.scale(). Wynik ma tę skalę, jeśli suma mieści się w zakresie typu int. Jeśli skala jest nieujemna, oznacza liczbę cyfr po kropce dziesiętnej. Dlatego 2.50 razy 1.25 daje 3.1250 o skali 4, łącznie z końcowym zerem. Jeśli suma wykracza poza zakres typu int, JDK 21 może zwrócić zero o skali ustawionej na najbliższą granicę tego zakresu. Na przykład jeśli a jest zerem o skali Integer.MAX_VALUE, a b ma skalę 1, wywołanie a.multiply(b) zwraca zero o skali Integer.MAX_VALUE.

Wywołanie a.multiply(b, mc) używa precyzji i trybu zaokrąglania z MathContext. Dodatnia precyzja ogranicza liczbę cyfr znaczących wyniku, a nie liczbę miejsc po kropce. Skala wyniku może się więc różnić od sumy skal operandów. Precyzja 0, na przykład w MathContext.UNLIMITED, oznacza dokładny iloczyn bez stosowania trybu zaokrąglania.

Argument null powoduje NullPointerException. Jeśli przy zadanej precyzji wynik byłby niedokładny, tryb RoundingMode.UNNECESSARY powoduje ArithmeticException. Taki wyjątek może też wystąpić, gdy skala potrzebna do zapisania wyniku wykracza poza zakres typu int.

Przykłady

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

Wynik

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

Argumenty tekstowe pozwalają wczytać wartości dziesiętne bez konwersji z `double`. Pierwszy wiersz pokazuje dokładny iloczyn, drugi wynik zaokrąglony do trzech cyfr znaczących w trybie `RoundingMode.HALF_UP`, a trzeci niezmienioną wartość `a`.

Powiązane lekcje

  • Java · Lekcja 4 · Podstawowy · Wersja: 2
  • Java · Lekcja 69 · Podstawowy · Wersja: 2

Źródła