CKTIS / Java
BigDecimal.add — dokładne dodawanie i zaokrąglanie
Dodawaj wartości BigDecimal bez zaokrąglania lub użyj MathContext, aby określić precyzję i tryb zaokrąglania wyniku.
Wersja: Java SE 21
Składnia
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 to metoda instancyjna klasy java.math.BigDecimal. W wywołaniu a.add(b) obiekt a i argument b są składnikami sumy. Nie można dodać dwóch obiektów BigDecimal operatorem +. Obiekty te są niemutowalne: metoda zwraca wynik i nie zmienia żadnego składnika. Zapisz lub wykorzystaj zwróconą wartość; samo a.add(b); nie aktualizuje a.
a.add(b) zwraca dokładną sumę o skali max(a.scale(), b.scale()). Nieujemna skala oznacza liczbę miejsc po kropce dziesiętnej, w tym końcowe zera. Skala może być ujemna: przy skali -2 wartość to zapisana liczba całkowita pomnożona przez 100.
a.add(b, mc) przyjmuje MathContext z pakietu java.math. Dodatnia precyzja ogranicza liczbę cyfr znaczących wyniku, a nie liczbę miejsc po kropce. Metoda zaokrągla dokładną sumę w razie potrzeby zgodnie z trybem z kontekstu, więc skala wyniku może się zmienić. Przy dodatniej precyzji, jeśli dokładnie jeden składnik jest zerem, wynik ma wartość liczbową niezerowego składnika, w razie potrzeby zaokrągloną. Skala wyniku może się różnić od skali niezerowego składnika nawet wtedy, gdy zaokrąglanie nie jest potrzebne. Na przykład dodanie 0.00 do 1 przy precyzji 3 daje 1.00. Precyzja 0, jak w MathContext.UNLIMITED, oznacza dodawanie bez zaokrąglania.
Jeśli zaokrąglenie zmieniłoby wartość, tryb RoundingMode.UNNECESSARY powoduje zgłoszenie ArithmeticException. Przekazanie null jako b lub mc powoduje zgłoszenie NullPointerException.
Przykłady
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());
}
}Wynik
12.750 12.8 12.40
Składniki utworzono z napisów, aby uniknąć wcześniejszej konwersji na `double`. Dokładna suma `12.750` ma skalę 3; przy trzech cyfrach znaczących `HALF_UP` daje `12.8`. Ostatni wiersz pokazuje, że `a` nadal ma wartość `12.40`.
Powiązane lekcje
- Java · Lekcja 4 · Podstawowy · Wersja: 2
- Java · Lekcja 69 · Podstawowy · Wersja: 2