База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

BigDecimal.subtract — изваждане на десетични числа

Извади две стойности от тип `BigDecimal` точно или закръгли разликата според настройките на `MathContext`. Нито един от операндите не се променя.

Версия: Java SE 21

Синтаксис

public BigDecimal subtract(BigDecimal subtrahend)
public BigDecimal subtract(BigDecimal subtrahend, MathContext mc)

BigDecimal.subtract е метод на екземпляр на класа java.math.BigDecimal. Извикването a.subtract(b) изчислява a − b: методът изважда аргумента от обекта, върху който е извикан. Редът има значение. Операторът - не може да се използва с обекти от тип BigDecimal.

subtract(BigDecimal) връща точната разлика без закръгляване. Нейният мащаб е Math.max(a.scale(), b.scale()). Неотрицателният мащаб показва броя на цифрите след десетичния разделител, включително крайните нули. Обектите BigDecimal са неизменяеми, затова и двата операнда остават непроменени. Запази върнатата стойност, ако ще използваш разликата по-късно.

subtract(BigDecimal, MathContext) при нужда закръгля точната разлика според точността и режима на закръгляване в контекста. Точността определя броя на значещите цифри, а не броя на десетичните знаци. Точност 0, както при MathContext.UNLIMITED, означава точно изчисление без закръгляване. Ако е нужно закръгляване, но режимът е RoundingMode.UNNECESSARY, методът хвърля ArithmeticException. Подаването на null като стойност за изваждане или като контекст води до NullPointerException.

Примери

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());
    }
}

Резултат

11.844
3
11.8
12.30
0.456

Конструкторите, които приемат низове, запазват точните десетични стойности без преобразуване през `double`. Програмата извежда точната разлика `11.844`, нейния мащаб `3`, резултата `11.8`, закръглен до три значещи цифри с `HALF_UP`, и накрая непроменените операнди `12.30` и `0.456`.

Свързани уроци

  • Java · Урок 69 · Начално · Версия: 2

Източници