WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

BigDecimal.toPlainString(): Dezimaldarstellung ohne Exponenten

Mit `toPlainString()` gibst du einen `BigDecimal`-Wert ohne Exponentialschreibweise aus. Beim Einlesen erhältst du denselben Zahlenwert, aber nicht immer die ursprüngliche Skala.

Version: Java SE 21

Syntax

public String toPlainString()

BigDecimal.toPlainString() ist eine Instanzmethode von java.math.BigDecimal. Sie hat keine Überladungen und wird ohne Argumente aufgerufen, etwa mit value.toPlainString(). Sie liefert einen String ohne Exponententeil (E), ohne zu runden oder das Objekt zu verändern.

Bei positiver Skala entspricht die Anzahl der Stellen nach dem Dezimalpunkt der Skala. Deshalb bleiben bei 1.2300 die Nullen am Ende erhalten. Bei Skala null oder negativer Skala enthält das Ergebnis keinen Dezimalpunkt: Aus 1E+3 wird 1000. Die Ausgabe ist unabhängig von den Regionseinstellungen: Sie verwendet einen Dezimalpunkt und keine Zifferngruppierung.

Verwende diese Methode, wenn du Text ohne Exponenten brauchst. new BigDecimal(text) stellt denselben Zahlenwert wieder her, aber aus einer negativen Skala wird 0. Daher liefert compareTo() den Wert 0, obwohl equals() den Wert false liefern kann: equals() prüft auch die Skala. Wenn beim Einlesen sowohl Wert als auch Skala erhalten bleiben sollen, verwende toString(), das Exponentialschreibweise verwenden kann.

Beispiele

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

Ergebnis

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

Die ersten beiden Zeilen vergleichen `toString()` mit `toPlainString()`. Die nächsten beiden zeigen Nullen am Ende und eine kleine negative Zahl. Beim Einlesen von `1000` ändert sich die Skala von `-3` auf `0`: Der numerische Vergleich liefert `0`, `equals()` dagegen `false`.

Zugehörige Lektionen

  • Java · Lektion 4 · Grundlagen · Version: 2
  • Java · Lektion 6 · Grundlagen · Version: 2
  • Java · Lektion 69 · Grundlagen · Version: 2

Quellen