Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

BigDecimal.toPlainString(): representação decimal sem expoente

Usa `toPlainString()` para escrever um `BigDecimal` sem notação exponencial. Ao leres o texto, recuperas o valor numérico, mas nem sempre a escala original.

Versão: Java SE 21

Sintaxe

public String toPlainString()

BigDecimal.toPlainString() é um método de instância de java.math.BigDecimal. Não tem sobrecargas e é chamado sem argumentos, por exemplo, com value.toPlainString(). Devolve uma String sem parte exponencial (E), sem arredondar nem alterar o objeto.

Se a escala for positiva, corresponde ao número de algarismos a seguir ao ponto decimal: 1.2300 mantém os zeros finais. Se a escala for zero ou negativa, o resultado não tem ponto decimal: 1E+3 passa a 1000. O resultado não depende das definições regionais: usa um ponto como separador decimal e não agrupa os algarismos.

Usa este método quando precisares de texto sem expoente. new BigDecimal(text) recupera o mesmo valor numérico, mas uma escala negativa passa a 0. Por isso, compareTo() devolve 0 mesmo quando equals() pode devolver false: equals() também verifica a escala. Se precisares de recuperar tanto o valor como a escala original, usa toString(), que pode recorrer à notação exponencial.

Exemplos

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

Resultado

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

As duas primeiras linhas comparam `toString()` com `toPlainString()`. As duas seguintes mostram os zeros finais e um número negativo próximo de zero. Ao ler `1000`, a escala passa de `-3` para `0`: a comparação numérica devolve `0`, enquanto `equals()` devolve `false`.

Lições relacionadas

  • Java · Lição 4 · Básico · Versão: 2
  • Java · Lição 6 · Básico · Versão: 2
  • Java · Lição 69 · Básico · Versão: 2

Fontes