Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła