Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

BigDecimal.toPlainString(): zapis dziesiętny bez wykładnika

Użyj `toPlainString()`, aby zapisać wartość `BigDecimal` bez notacji wykładniczej. Odczytanie tego tekstu przywraca wartość liczbową, ale nie zawsze pierwotną skalę.

Wersja: Java SE 21

Składnia

public String toPlainString()

BigDecimal.toPlainString() to metoda instancji klasy java.math.BigDecimal. Nie ma przeciążeń: wywołujesz ją bez argumentów, np. value.toPlainString(). Zwraca String bez części wykładniczej (E), bez zaokrąglania i bez zmiany obiektu.

Przy dodatniej skali liczba cyfr po kropce dziesiętnej odpowiada skali, dlatego 1.2300 zachowuje końcowe zera. Przy skali zerowej lub ujemnej wynik nie ma kropki: 1E+3 daje 1000. Wynik nie zależy od ustawień regionalnych: używa kropki jako separatora dziesiętnego i nie grupuje cyfr.

Użyj tej metody, gdy potrzebujesz tekstu bez wykładnika. new BigDecimal(text) odtwarza tę samą wartość liczbową, ale ujemna skala zmienia się wtedy na 0. Dlatego compareTo() zwraca 0, choć equals() może zwrócić false, bo uwzględnia także skalę. Jeśli po odczycie potrzebujesz tej samej wartości i skali, użyj toString(), które może zapisać liczbę z wykładnikiem.

Przykłady

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

Wynik

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

Pierwsze dwa wiersze porównują `toString()` z `toPlainString()`. Kolejne dwa pokazują końcowe zera i małą liczbę ujemną. Po odczytaniu `1000` skala zmienia się z `-3` na `0`: porównanie liczbowe zwraca `0`, a `equals()` zwraca `false`.

Powiązane lekcje

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

Źródła