CKTIS / Java
BigDecimal.add — точно събиране и закръгляване
Събирайте стойности BigDecimal без закръгляване или задайте точността и режима на закръгляване на резултата чрез MathContext.
Версия: Java SE 21
Синтаксис
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 е метод на екземпляр от класа java.math.BigDecimal. При a.add(b) обектът a и аргументът b са двете събираеми. Два обекта BigDecimal не могат да се събират с оператора +. Те са неизменяеми: методът връща резултата, без да променя събираемите. Запазете или използвайте върнатата стойност; само a.add(b); не променя a.
a.add(b) връща точния сбор с мащаб max(a.scale(), b.scale()). Неотрицателният мащаб показва броя на цифрите след десетичния разделител, включително крайните нули. Мащабът може да е и отрицателен: при -2 стойността е съхраненото цяло число, умножено по 100.
a.add(b, mc) приема MathContext от пакета java.math. Положителната точност ограничава броя на значещите цифри в резултата, а не броя на десетичните знаци. При нужда методът закръгля точния сбор според режима в контекста, така че мащабът на резултата може да се промени. При положителна точност, ако само едното събираемо е нула, резултатът има числовата стойност на ненулевото събираемо, закръглена при нужда. Мащабът на резултата може да се различава от този на ненулевото събираемо дори когато не е необходимо закръгляване. Например при точност 3 добавянето на 0.00 към 1 дава 1.00. Точност 0, както в MathContext.UNLIMITED, означава събиране без закръгляване.
Ако закръгляването би променило стойността, RoundingMode.UNNECESSARY води до изключение ArithmeticException. Подаването на null като b или mc води до изключение 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.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());
}
}Резултат
12.750 12.8 12.40
Събираемите се създават от низове, за да се избегне предварително преобразуване към `double`. Точният сбор `12.750` е с мащаб 3; при три значещи цифри `HALF_UP` дава `12.8`. Последният ред показва, че `a` все още има стойност `12.40`.
Свързани уроци
- Java · Урок 4 · Начално · Версия: 2
- Java · Урок 69 · Начално · Версия: 2