Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

BigDecimal.toPlainString(): rappresentazione decimale senza esponente

Usa `toPlainString()` per scrivere un `BigDecimal` senza notazione esponenziale. Rileggendo il testo recuperi il valore numerico, ma non sempre la scala originale.

Versione: Java SE 21

Sintassi

public String toPlainString()

BigDecimal.toPlainString() è un metodo di istanza di java.math.BigDecimal. Non ha overload e si chiama senza argomenti, ad esempio con value.toPlainString(). Restituisce una String senza la parte esponenziale (E), senza arrotondare né modificare l’oggetto.

Se la scala è positiva, corrisponde al numero di cifre dopo il punto decimale: 1.2300 conserva quindi gli zeri finali. Se la scala è zero o negativa, il risultato non contiene il punto decimale: 1E+3 diventa 1000. Il risultato non dipende dalle impostazioni locali: usa il punto come separatore decimale e non raggruppa le cifre.

Usa questo metodo quando ti serve del testo senza esponente. new BigDecimal(text) ricostruisce lo stesso valore numerico, ma una scala negativa diventa 0. Per questo compareTo() restituisce 0 anche se equals() può restituire false: equals() controlla anche la scala. Per recuperare sia il valore sia la scala originale, usa toString(), che può ricorrere alla notazione esponenziale.

Esempi

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

Risultato

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

Le prime due righe confrontano `toString()` e `toPlainString()`. Le due successive mostrano gli zeri finali e un numero negativo vicino a zero. Rileggendo `1000`, la scala passa da `-3` a `0`: il confronto numerico restituisce `0`, mentre `equals()` restituisce `false`.

Lezioni correlate

  • Java · Lezione 4 · Base · Versione: 2
  • Java · Lezione 6 · Base · Versione: 2
  • Java · Lezione 69 · Base · Versione: 2

Fonti