CKTIS / Java
BigDecimal.subtract — odejmowanie liczb dziesiętnych
Odejmij dwie wartości `BigDecimal` dokładnie albo zaokrąglij różnicę zgodnie z ustawieniami `MathContext`. Żaden z argumentów odejmowania nie zmienia wartości.
Wersja: Java SE 21
Składnia
public BigDecimal subtract(BigDecimal subtrahend)
public BigDecimal subtract(BigDecimal subtrahend, MathContext mc)BigDecimal.subtract to metoda instancji klasy java.math.BigDecimal. Wywołanie a.subtract(b) oblicza a − b: metoda odejmuje argument od obiektu, na którym ją wywołujesz. Kolejność ma znaczenie. Operator - nie działa na obiektach BigDecimal.
subtract(BigDecimal) zwraca dokładną różnicę bez zaokrąglania, ze skalą równą Math.max(a.scale(), b.scale()). Nieujemna skala określa liczbę cyfr po separatorze dziesiętnym, w tym końcowych zer. BigDecimal jest niemutowalny: oba operandy pozostają bez zmian. Jeśli chcesz użyć różnicy później, zapisz wartość zwróconą przez metodę.
subtract(BigDecimal, MathContext) w razie potrzeby zaokrągla dokładną różnicę zgodnie z precyzją i trybem zaokrąglania z kontekstu. Precyzja dotyczy cyfr znaczących, nie miejsc po przecinku. Precyzja 0, np. w MathContext.UNLIMITED, oznacza obliczenie dokładne bez zaokrąglania. Jeśli trzeba zaokrąglić, a tryb to RoundingMode.UNNECESSARY, metoda zgłasza ArithmeticException. Przekazanie null zamiast odejmowanej wartości lub kontekstu powoduje 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.30");
BigDecimal b = new BigDecimal("0.456");
BigDecimal exact = a.subtract(b);
BigDecimal rounded = a.subtract(b, new MathContext(3, RoundingMode.HALF_UP));
System.out.println(exact.toPlainString());
System.out.println(exact.scale());
System.out.println(rounded.toPlainString());
System.out.println(a.toPlainString());
System.out.println(b.toPlainString());
}
}Wynik
11.844 3 11.8 12.30 0.456
Konstruktory przyjmujące tekst zachowują dokładne wartości dziesiętne bez konwersji przez `double`. Program wypisuje dokładną różnicę `11.844`, jej skalę `3`, wynik `11.8` zaokrąglony do trzech cyfr znaczących w trybie `HALF_UP`, a na końcu niezmienione operandy `12.30` i `0.456`.
Powiązane lekcje
- Java · Lekcja 69 · Podstawowy · Wersja: 2