Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

BigDecimal: točno decimalno računanje, skala i usporedba

Učitaj decimalne vrijednosti bez pretvorbe preko `double`, računaj točno, odaberi skalu i pravilo zaokruživanja te uspoređuj brojeve neovisno o skali.

Verzija: Java SE 21

Sintaksa

java.math.BigDecimal — Java SE 21

BigDecimal(String val)
BigDecimal add(BigDecimal augend)
BigDecimal multiply(BigDecimal multiplicand)
BigDecimal setScale(int newScale)
BigDecimal setScale(int newScale, RoundingMode roundingMode)
BigDecimal stripTrailingZeros()
int compareTo(BigDecimal val)
String toPlainString()

RoundingMode: java.math.RoundingMode

U Java SE 21 konstruktor BigDecimal(String) iz paketa java.math točno učitava decimalnu vrijednost bez pretvorbe preko double. Upotrijebi decimalnu točku, a ne zarez; bjeline i razdjelnici skupina znamenaka nisu dopušteni. Nevaljan zapis izaziva NumberFormatException. Bez eksponenta skala je broj znamenaka iza točke, uključujući završne nule; navedeni se eksponent oduzima od te skale.

Metode s jednim argumentom BigDecimal.add i BigDecimal.multiply vraćaju točan zbroj odnosno umnožak. Skala zbroja je veća od dviju skala operanada ili jednaka objema ako su iste; preferirana skala umnoška je zbroj skala operanada. U JDK-u 21 množenje može izazvati ArithmeticException ako je taj zbroj izvan raspona tipa int. Ako objekt na kojem se metoda poziva (this) ima vrijednost nula, metoda umjesto toga vraća nulu sa skalom postavljenom na najbližu granicu tog raspona. Preopterećene inačice s MathContext mogu zaokružiti prema tom kontekstu. Objekti BigDecimal nepromjenjivi su: spremi vraćeni rezultat jer se operandi ne mijenjaju.

BigDecimal.setScale postavlja skalu rezultata. setScale(int) izaziva ArithmeticException ako je potrebno zaokruživanje; setScale(int, RoundingMode) omogućuje odabir pravila. HALF_UP zaokružuje na najbližu vrijednost, a na pola puta od nule. UNNECESSARY izaziva ArithmeticException ako je potrebno zaokruživanje. Preopterećena inačica setScale(int, int) zastarjela je.

BigDecimal.stripTrailingZeros uklanja završne nule iz zapisa bez promjene vrijednosti. Skala može postati negativna, kao kod 600.0 nakon uklanjanja nula (skala -2); za nulu metoda vraća BigDecimal.ZERO. Prekoračenje raspona skale izaziva ArithmeticException. BigDecimal.toPlainString vraća tekst bez eksponenta i bez oblikovanja prema regionalnim postavkama. Za fiksan broj decimalnih mjesta prvo postavi skalu. Ponovno učitavanje teksta čuva vrijednost, ali ne nužno i skalu.

BigDecimal.compareTo uspoređuje brojeve neovisno o skali: vraća -1, 0 ili 1 kada je prvi operand manji od drugog, jednak drugom ili veći od drugog. Za brojčanu jednakost upotrijebi a.compareTo(b) == 0; equals zahtijeva istu vrijednost i istu skalu pa za 2.0 i 2.00 vraća false.

Primjeri

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

public class Main {
    public static void main(String[] args) {
        BigDecimal unitPrice = new BigDecimal("2.500");
        BigDecimal quantity = new BigDecimal("3");
        BigDecimal fee = new BigDecimal("0.005");
        BigDecimal exact = unitPrice.multiply(quantity).add(fee);
        BigDecimal rounded = exact.setScale(2, RoundingMode.HALF_UP);

        BigDecimal stripped = new BigDecimal("600.0").stripTrailingZeros();
        BigDecimal sameValue = new BigDecimal("600.00");

        System.out.println("exact: " + exact.toPlainString());
        System.out.println("rounded: " + rounded.toPlainString());
        System.out.println("stripped scale: " + stripped.scale());
        System.out.println("plain: " + stripped.toPlainString());
        System.out.println("compareTo: " + stripped.compareTo(sameValue));
        System.out.println("equals: " + stripped.equals(sameValue));
    }
}

Rezultat

exact: 7.505
rounded: 7.51
stripped scale: -2
plain: 600
compareTo: 0
equals: false

Točan rezultat `7.505` zaokružuje se na `7.51`. Nakon uklanjanja nula iz `600.0` skala je `-2`, ali zapis bez eksponenta glasi `600`. Usporedba s `600.00` daje `0`, dok `equals` vraća `false`.

Povezane lekcije

  • Java · Lekcija 60 · Srednje · Verzija: 2

Izvori