Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

BigDecimal.valueOf — vytváření desetinných hodnot

Seznam se se třemi přetíženími `BigDecimal.valueOf` v Javě 21 a zjisti, proč převod hodnoty `double` může dát jiný výsledek než volání konstruktoru.

Verze: Java SE 21

Syntaxe

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 je statická tovární metoda třídy java.math.BigDecimal. Po přidání import java.math.BigDecimal; ji voláš přes název třídy bez new. V Javě SE 21 má tři přetížení.

valueOf(long) zachová celočíselnou hodnotu a nastaví měřítko na 0. valueOf(long unscaledVal, int scale) vrátí přesnou hodnotu unscaledVal × 10^(−scale) se zadaným měřítkem. Například BigDecimal.valueOf(1250L, 2) vrátí 12.50 s měřítkem 2. Měřítko může být záporné: BigDecimal.valueOf(125L, -2) má číselnou hodnotu 12500 a měřítko -2.

Pro konečnou hodnotu double d dává valueOf(double) stejný výsledek jako new BigDecimal(Double.toString(d)): použije kanonický desetinný textový zápis hodnoty d. Naproti tomu new BigDecimal(d) zapíše v desítkové soustavě přesnou binární hodnotu uloženou v d. Proto BigDecimal.valueOf(0.1) vrátí přesně 0.1, zatímco new BigDecimal(0.1) vrátí o něco větší hodnotu. Obě varianty vyvolají výjimku NumberFormatException pro NaN i pro obě nekonečna.

Převod neobnoví dříve ztracenou přesnost. Ve výrazu BigDecimal.valueOf(0.1 + 0.2) se nejprve sčítá v typu double, takže výsledkem je 0.30000000000000004. Pokud máš přesný desetinný zápis v textu, použij new BigDecimal("0.1") bez mezikroku přes double. Přetížení BigDecimal.valueOf(String) neexistuje.

Příklady

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

Výsledek

0.1
0.1000000000000000055511151231257827021181583404541015625
125
12.50
0.30000000000000004

První dva řádky porovnávají tovární metodu a konstruktor pro stejnou hodnotu `double`. Třetí a čtvrtý ukazují celočíselná přetížení a poslední ukazuje vliv předchozího sčítání v typu `double`. `toPlainString()` vrací textovou podobu hodnoty bez exponentového zápisu a `println` tento text vypisuje.

Související lekce

  • Java · Lekce 4 · Základní · Verze: 2
  • Java · Lekce 6 · Základní · Verze: 2

Zdroje