Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

BigDecimal.valueOf — tworzenie liczb dziesiętnych

Poznaj trzy przeciążenia `BigDecimal.valueOf` w Javie 21 i dowiedz się, dlaczego konwersja z `double` różni się od wywołania konstruktora z tym samym argumentem.

Wersja: Java SE 21

Składnia

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 to statyczna metoda fabryczna klasy java.math.BigDecimal. Po dodaniu import java.math.BigDecimal; wywołujesz ją na nazwie klasy, bez new. W Javie SE 21 ma trzy przeciążenia.

valueOf(long) zachowuje wartość całkowitą i ustawia skalę na 0. valueOf(long unscaledVal, int scale) zwraca dokładną wartość unscaledVal × 10^(−scale) z podaną skalą. Na przykład BigDecimal.valueOf(1250L, 2) daje 12.50 o skali 2. Skala może być ujemna: BigDecimal.valueOf(125L, -2) daje wartość liczbową 12500 o skali -2.

Dla skończonego double d metoda valueOf(double) tworzy taki wynik jak new BigDecimal(Double.toString(d)): korzysta z kanonicznego zapisu dziesiętnego wartości d. Natomiast new BigDecimal(d) zapisuje dziesiętnie dokładną wartość binarną przechowywaną w d. Dlatego BigDecimal.valueOf(0.1) daje dokładnie 0.1, a new BigDecimal(0.1) daje nieco większą wartość. Obie formy zgłaszają NumberFormatException dla NaN i obu nieskończoności.

Konwersja nie odzyskuje precyzji utraconej wcześniej: w BigDecimal.valueOf(0.1 + 0.2) dodawanie odbywa się najpierw w typie double, więc wynikiem jest 0.30000000000000004. Jeśli punktem wyjścia jest dokładny zapis dziesiętny, użyj new BigDecimal("0.1") zamiast pośredniej konwersji na double. Nie ma przeciążenia BigDecimal.valueOf(String).

Przykłady

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

Wynik

0.1
0.1000000000000000055511151231257827021181583404541015625
125
12.50
0.30000000000000004

Pierwsze dwa wiersze porównują fabrykę i konstruktor dla tego samego `double`. Trzeci i czwarty pokazują przeciążenia całkowite, a ostatni — skutek wcześniejszego dodawania w `double`. `toPlainString()` zwraca tekstowy zapis wartości bez notacji wykładniczej, a `println` wypisuje ten tekst.

Powiązane lekcje

  • Java · Lekcja 4 · Podstawowy · Wersja: 2
  • Java · Lekcja 6 · Podstawowy · Wersja: 2

Źródła