CKTIS / Java
Умножение на десетични числа с BigDecimal.multiply
Умножете две стойности `BigDecimal` точно или закръглете произведението според точността и режима на закръгляване, зададени в `MathContext`.
Версия: Java SE 21
Синтаксис
public BigDecimal multiply(BigDecimal multiplicand)
public BigDecimal multiply(BigDecimal multiplicand, MathContext mc)В Java SE 21 BigDecimal.multiply е метод на екземпляр на класа java.math.BigDecimal. За да умножите два обекта BigDecimal, напишете a.multiply(b), а не a * b. И двата варианта на метода връщат произведението като BigDecimal. Обектите са неизменяеми: нито един от операндите не се променя. Запазете върнатата стойност, ако ще ви трябва по-късно.
Извикването a.multiply(b) връща точното произведение. Предпочитаният мащаб е сборът на a.scale() и b.scale(). Резултатът има този мащаб, ако сборът е в диапазона на типа int. Когато мащабът е неотрицателен, той показва броя на цифрите след десетичния разделител. Така 2.50 по 1.25 дава 3.1250 с мащаб 4, включително последната нула. Ако сборът е извън диапазона на типа int, JDK 21 може да върне нула с мащаб, равен на най-близката граница на този диапазон. Например, ако a е нула с мащаб Integer.MAX_VALUE, а b е с мащаб 1, a.multiply(b) връща нула с мащаб Integer.MAX_VALUE.
Извикването a.multiply(b, mc) използва точността и режима на закръгляване от MathContext. Положителната точност ограничава броя на значещите цифри в резултата, а не броя на десетичните знаци. Затова мащабът на резултата може да се различава от сбора на мащабите на операндите. Точност 0, както в MathContext.UNLIMITED, изисква точно произведение, без да се използва режимът на закръгляване.
Подаването на null като аргумент води до NullPointerException. Ако резултатът не може да бъде точен при зададената точност, RoundingMode.UNNECESSARY води до ArithmeticException. Това изключение може да възникне и когато необходимият за резултата мащаб е извън диапазона на типа int.
Примери
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("2.50");
BigDecimal b = new BigDecimal("1.25");
BigDecimal exact = a.multiply(b);
BigDecimal rounded = a.multiply(b, new MathContext(3, RoundingMode.HALF_UP));
System.out.println(exact.toPlainString() + " (scale=" + exact.scale() + ")");
System.out.println(rounded.toPlainString() + " (scale=" + rounded.scale() + ")");
System.out.println(a.toPlainString());
}
}Резултат
3.1250 (scale=4) 3.13 (scale=2) 2.50
Низовете задават десетичните стойности без преобразуване от `double`. Първият ред показва точното произведение, вторият — резултата, закръглен до три значещи цифри с `RoundingMode.HALF_UP`, а третият — непроменената стойност на `a`.
Свързани уроци
- Java · Урок 4 · Начално · Версия: 2
- Java · Урок 69 · Начално · Версия: 2