Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Dzielenie BigDecimal z określoną skalą i trybem zaokrąglania

To przeciążenie metody `divide` pozwala podać skalę ilorazu oraz regułę zaokrąglania. Wynik ma wskazaną skalę także wtedy, gdy dzielenie jest dokładne.

Wersja: Java SE 21

Składnia

public BigDecimal divide(BigDecimal divisor, int scale, RoundingMode roundingMode)

BigDecimal quotient = dividend.divide(divisor, scale, roundingMode);

dividend.divide(divisor, scale, roundingMode) dzieli dividend przez divisor. Oba argumenty dzielenia są typu java.math.BigDecimal, a metoda zwraca iloraz, nie zmieniając żadnego z nich. Typ int parametru scale określa skalę wyniku, a java.math.RoundingMode wskazuje, jak zaokrąglić iloraz, jeśli jest to potrzebne.

Skala 2 oznacza dwa miejsca po kropce dziesiętnej, łącznie z końcowymi zerami. Skala 0 oznacza wynik bez części ułamkowej, a skala -2 — wielokrotność 100. Skala nie oznacza liczby cyfr znaczących. HALF_UP wybiera najbliższą wartość o danej skali, a w połowie odległości wybiera tę dalszą od zera.

Dzielenie przez zero zgłasza ArithmeticException. Ten sam wyjątek występuje przy UNNECESSARY, jeśli dokładnego ilorazu nie da się zapisać w podanej skali bez zaokrąglenia. Dokładne 0.5 można zapisać w skali 2 jako 0.50 bez zmiany wartości.

divide(divisor, roundingMode) stosuje skalę dzielnej. divide(divisor) wymaga dokładnego wyniku i zgłasza wyjątek, gdy rozwinięcie dziesiętne jest nieskończone. divide(divisor, mathContext) korzysta z precyzji i trybu zaokrąglania z kontekstu zamiast przyjmować zadaną skalę. Starsze przeciążenie z trybem przekazywanym jako int jest przestarzałe; używaj RoundingMode.

Przykłady

import java.math.BigDecimal;
import java.math.RoundingMode;

public class Main {
    public static void main(String[] args) {
        BigDecimal one = BigDecimal.ONE;
        BigDecimal rounded = one.divide(BigDecimal.valueOf(8), 2, RoundingMode.HALF_UP);
        BigDecimal exact = one.divide(BigDecimal.valueOf(2), 2, RoundingMode.HALF_UP);

        System.out.println(rounded.toPlainString());
        System.out.println(exact.toPlainString());
    }
}

Wynik

0.13
0.50

Dokładny iloraz `1 / 8` to `0.125`, więc `HALF_UP` daje `0.13`. Iloraz `1 / 2` nie wymaga zaokrąglenia: `toPlainString()` wypisuje `0.50`, zachowując zero wynikające ze skali `2`.

Powiązane lekcje

  • Java · Lekcja 69 · Podstawowy · Wersja: 2

Źródła