Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła