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