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

CKTIS / Java

BigDecimal.toPlainString(): desetinný zápis bez exponentu

Metoda `toPlainString()` zapíše hodnotu `BigDecimal` bez exponenciálního zápisu. Načtením textu získáš stejnou číselnou hodnotu, ale ne vždy původní měřítko.

Verze: Java SE 21

Syntaxe

public String toPlainString()

BigDecimal.toPlainString() je instanční metoda třídy java.math.BigDecimal. Nemá žádné přetížené varianty a volá se bez argumentů, například value.toPlainString(). Vrací String bez části s exponentem (E), aniž by zaokrouhlovala nebo měnila objekt.

Při kladném měřítku (scale) odpovídá počet číslic za desetinnou tečkou měřítku, takže 1.2300 si ponechá koncové nuly. Při nulovém nebo záporném měřítku výsledek desetinnou tečku neobsahuje: z 1E+3 vznikne 1000. Výstup nezávisí na místním nastavení: používá desetinnou tečku a neseskupuje číslice.

Tuto metodu použij, když potřebuješ text bez exponentu. new BigDecimal(text) obnoví stejnou číselnou hodnotu, ale záporné měřítko se změní na 0. Proto compareTo() vrátí 0, i když equals() může vrátit false: equals() kontroluje i měřítko. Pokud potřebuješ obnovit hodnotu i původní měřítko, použij toString(), která může použít exponenciální zápis.

Příklady

import java.math.BigDecimal;

public class Main {
    public static void main(String[] args) {
        BigDecimal original = new BigDecimal("1E+3");
        String plain = original.toPlainString();
        BigDecimal parsed = new BigDecimal(plain);

        System.out.println(original.toString());
        System.out.println(plain);
        System.out.println(new BigDecimal("1.2300").toPlainString());
        System.out.println(new BigDecimal("-1E-7").toPlainString());
        System.out.println(original.scale() + " -> " + parsed.scale());
        System.out.println(original.compareTo(parsed));
        System.out.println(original.equals(parsed));
    }
}

Výsledek

1E+3
1000
1.2300
-0.0000001
-3 -> 0
0
false

První dva řádky porovnávají `toString()` a `toPlainString()`. Další dva ukazují koncové nuly a záporné číslo blízké nule. Načtením `1000` se měřítko změní z `-3` na `0`: číselné porovnání vrátí `0`, zatímco `equals()` vrátí `false`.

Související lekce

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

Zdroje