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