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

CKTIS / Java

Dělení BigDecimal se zadanou škálou a režimem zaokrouhlování

Toto přetížení metody `divide` umožňuje nastavit škálu podílu a zvolit pravidlo zaokrouhlování. Výsledek má zadanou škálu, i když je dělení přesné.

Verze: Java SE 21

Syntaxe

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

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

dividend.divide(divisor, scale, roundingMode) vydělí dividend hodnotou divisor. Oba operandy jsou typu java.math.BigDecimal a metoda je nemění. Argument scale typu int určuje škálu výsledku. Argument typu java.math.RoundingMode říká, jak v případě potřeby zaokrouhlit.

Škála 2 znamená dvě místa za desetinným oddělovačem včetně koncových nul. Škála 0 dává celé číslo a škála -2 násobek 100. Škála není počet platných číslic. HALF_UP volí nejbližší hodnotu při zadané škále; při stejné vzdálenosti volí hodnotu dál od nuly.

Dělení nulou vyvolá výjimku ArithmeticException. Totéž platí při použití UNNECESSARY, pokud přesný podíl nelze při zadané škále vyjádřit bez zaokrouhlení. Přesnou hodnotu 0.5 lze při škále 2 zapsat jako 0.50, aniž by se její hodnota změnila.

divide(divisor, roundingMode) používá škálu dělence. divide(divisor) vyžaduje přesný výsledek a vyvolá výjimku, pokud desetinný rozvoj není konečný. divide(divisor, mathContext) používá přesnost a režim zaokrouhlování z kontextu namísto zadané škály. Starší přetížení, které přijímá režim zaokrouhlování jako int, je zastaralé; místo něj použij RoundingMode.

Příklady

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

Výsledek

0.13
0.50

Přesný podíl `1 / 8` je `0.125`, takže `HALF_UP` dá `0.13`. Podíl `1 / 2` není třeba zaokrouhlit: `toPlainString()` vypíše `0.50` a zachová koncovou nulu danou škálou `2`.

Související lekce

  • Java · Lekce 69 · Základní · Verze: 2

Zdroje