CKTIS / Java
BigDecimal: natančno decimalno računanje, skala in primerjava
Preberi decimalne vrednosti brez pretvorbe prek `double`, računaj natančno, izberi skalo in pravilo zaokroževanja ter primerjaj števila ne glede na skalo.
Različica: 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.RoundingModeV Java SE 21 konstruktor BigDecimal(String) iz paketa java.math natančno prebere decimalno vrednost brez pretvorbe prek double. Uporabi decimalno piko, ne vejice; presledki in drugi beli znaki ter ločila skupin števk niso dovoljeni. Neveljaven zapis sproži NumberFormatException. Brez eksponenta skala pove število števk za piko, vključno s končnimi ničlami; če je eksponent podan, se od te skale odšteje.
Metodi BigDecimal.add in BigDecimal.multiply z enim argumentom vrneta natančno vsoto oziroma produkt. Skala vsote je večja od obeh skal operandov oziroma njuna skupna vrednost, če sta enaki; prednostna skala produkta je vsota njunih skal. Če je ta vsota zunaj obsega tipa int, lahko množenje v JDK 21 sproži ArithmeticException. Če ima objekt, na katerem je metoda poklicana (this), vrednost nič, metoda namesto tega vrne nič s skalo, omejeno na najbližjo mejo obsega tipa int. Preobremenjene različice z MathContext lahko zaokrožijo glede na ta kontekst. Objekti BigDecimal so nespremenljivi: shrani vrnjeni rezultat, ker se operanda ne spremenita.
BigDecimal.setScale določi skalo rezultata. setScale(int) sproži ArithmeticException, če bi bilo potrebno zaokroževanje; setScale(int, RoundingMode) omogoča izbiro pravila. HALF_UP zaokroži na najbližjo vrednost, pri enaki oddaljenosti pa stran od ničle. UNNECESSARY sproži ArithmeticException, če je potrebno zaokrožiti. Preobremenjena različica setScale(int, int) je zastarela.
BigDecimal.stripTrailingZeros odstrani končne ničle iz zapisa, ne da bi spremenila vrednost. Skala lahko postane negativna, kot pri 600.0 po odstranitvi ničel (skala -2); za ničlo metoda vrne BigDecimal.ZERO. Prekoračitev obsega skale sproži ArithmeticException. BigDecimal.toPlainString vrne besedilo brez eksponenta in brez krajevno odvisnega oblikovanja. Za stalno število decimalnih mest najprej nastavi skalo. Ob ponovnem branju besedila se vrednost ohrani, skala pa ne nujno.
BigDecimal.compareTo primerja številski vrednosti ne glede na skalo: vrne -1, 0 ali 1, če je prvi operand manjši od drugega, mu je enak ali je večji od njega. Številsko enakost preveri z a.compareTo(b) == 0; equals zahteva enako vrednost in enako skalo, zato za 2.0 in 2.00 vrne false.
Primeri
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
Natančni rezultat `7.505` se zaokroži na `7.51`. Po odstranitvi ničel iz `600.0` je skala `-2`, vendar je zapis brez eksponenta `600`. Primerjava s `600.00` vrne `0`, medtem ko `equals` vrne `false`.
Povezane lekcije
- Java · Lekcija 60 · Srednja · Različica: 2