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

CKTIS / Java

BigDecimal.valueOf — създаване на десетични стойности

Научи трите претоварени варианта на `BigDecimal.valueOf` в Java 21 и защо преобразуването на `double` може да даде различен резултат от извикването на конструктора.

Версия: Java SE 21

Синтаксис

import java.math.BigDecimal;

// Static overloads declared by java.math.BigDecimal:
public static BigDecimal valueOf(long val)
public static BigDecimal valueOf(long unscaledVal, int scale)
public static BigDecimal valueOf(double val)

BigDecimal.valueOf е статичен фабричен метод на класа java.math.BigDecimal. След като добавиш import java.math.BigDecimal;, извикваш метода чрез името на класа, без new. В Java SE 21 има три претоварени варианта.

valueOf(long) запазва целочислената стойност и задава мащаб 0. valueOf(long unscaledVal, int scale) връща точната стойност unscaledVal × 10^(−scale) с посочения мащаб. Например BigDecimal.valueOf(1250L, 2) дава 12.50 с мащаб 2. Мащабът може да е отрицателен: BigDecimal.valueOf(125L, -2) има числова стойност 12500 и мащаб -2.

За крайна стойност double d методът valueOf(double) дава същия резултат като new BigDecimal(Double.toString(d)): използва каноничния десетичен текстов запис на d. За разлика от него new BigDecimal(d) представя в десетичен вид точната двоична стойност, съхранена в d. Затова BigDecimal.valueOf(0.1) дава точно 0.1, а new BigDecimal(0.1) дава малко по-голяма стойност. И двете форми хвърлят NumberFormatException при NaN и при двете безкрайности.

Преобразуването не може да възстанови вече изгубена точност. В BigDecimal.valueOf(0.1 + 0.2) събирането се извършва първо в тип double, затова резултатът е 0.30000000000000004. Ако разполагаш с точен десетичен запис като текст, използвай new BigDecimal("0.1"), без да минаваш през double. Няма вариант BigDecimal.valueOf(String).

Примери

import java.math.BigDecimal;

public class Main {
    public static void main(String[] args) {
        double input = 0.1;
        System.out.println(BigDecimal.valueOf(input).toPlainString());
        System.out.println(new BigDecimal(input).toPlainString());
        System.out.println(BigDecimal.valueOf(125L).toPlainString());
        System.out.println(BigDecimal.valueOf(1250L, 2).toPlainString());
        System.out.println(BigDecimal.valueOf(0.1 + 0.2).toPlainString());
    }
}

Резултат

0.1
0.1000000000000000055511151231257827021181583404541015625
125
12.50
0.30000000000000004

Първите два реда сравняват фабричния метод и конструктора за една и съща стойност от тип `double`. Третият и четвъртият показват вариантите с цели числа, а последният показва ефекта от предходно събиране в тип `double`. `toPlainString()` връща текстов запис на стойността без експоненциален запис, а `println` извежда този текст.

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

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

Източници