CKTIS / Java
BigDecimal.add — točno zbrajanje i zaokruživanje
Zbrojite vrijednosti BigDecimal bez zaokruživanja ili s pomoću MathContext odredite preciznost i način zaokruživanja rezultata.
Verzija: Java SE 21
Sintaksa
import java.math.BigDecimal;
import java.math.MathContext;
BigDecimal exact = a.add(b);
BigDecimal rounded = a.add(b, mc);
// Instance method signatures in java.math.BigDecimal:
// public BigDecimal add(BigDecimal augend)
// public BigDecimal add(BigDecimal augend, MathContext mc)BigDecimal.add je instancijska metoda klase java.math.BigDecimal. U pozivu a.add(b) objekt a i argument b dva su pribrojnika. Dva objekta BigDecimal ne mogu se zbrojiti operatorom +. Ti su objekti nepromjenjivi: metoda vraća rezultat i ne mijenja nijedan pribrojnik. Spremite ili upotrijebite vraćenu vrijednost; sam poziv a.add(b); ne mijenja a.
a.add(b) vraća točan zbroj sa skalom max(a.scale(), b.scale()). Nenegativna skala označava broj decimalnih mjesta, uključujući završne nule. Skala može biti i negativna: sa skalom -2 vrijednost je pohranjeni cijeli broj pomnožen sa 100.
a.add(b, mc) prima MathContext iz paketa java.math. Pozitivna preciznost ograničava broj značajnih znamenaka rezultata, a ne broj decimalnih mjesta. Metoda po potrebi zaokružuje točan zbroj prema načinu iz konteksta, pa se skala rezultata može promijeniti. Ako je uz pozitivnu preciznost točno jedan pribrojnik nula, rezultat ima brojčanu vrijednost pribrojnika koji nije nula, po potrebi zaokruženu. Skala rezultata može se razlikovati od skale tog pribrojnika čak i kada zaokruživanje nije potrebno. Na primjer, ako uz preciznost 3 broju 1 pribrojimo 0.00, dobivamo 1.00. Preciznost 0, kao u MathContext.UNLIMITED, znači zbrajanje bez zaokruživanja.
Ako bi zaokruživanje promijenilo vrijednost, RoundingMode.UNNECESSARY uzrokuje iznimku ArithmeticException. Ako kao b ili mc proslijedite null, nastaje iznimka NullPointerException.
Primjeri
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("12.40");
BigDecimal b = new BigDecimal("0.350");
MathContext mc = new MathContext(3, RoundingMode.HALF_UP);
BigDecimal exact = a.add(b);
BigDecimal rounded = a.add(b, mc);
System.out.println(exact.toPlainString());
System.out.println(rounded.toPlainString());
System.out.println(a.toPlainString());
}
}Rezultat
12.750 12.8 12.40
Pribrojnici se stvaraju iz znakovnih nizova kako bi se izbjegla prethodna pretvorba u `double`. Točan zbroj `12.750` ima skalu 3; uz tri značajne znamenke `HALF_UP` daje `12.8`. Posljednji redak pokazuje da `a` i dalje ima vrijednost `12.40`.
Povezane lekcije
- Java · Lekcija 4 · Osnovno · Verzija: 2
- Java · Lekcija 69 · Osnovno · Verzija: 2