CKTIS / Java
BigDecimal.toPlainString() : écriture décimale sans exposant
Utilisez `toPlainString()` pour écrire un `BigDecimal` sans notation exponentielle. La relecture du texte restitue la valeur numérique, mais pas toujours l’échelle d’origine.
Version : Java SE 21
Syntaxe
public String toPlainString()BigDecimal.toPlainString() est une méthode d’instance de java.math.BigDecimal. Elle n’a pas de surcharge et s’appelle sans argument, par exemple value.toPlainString(). Elle renvoie une String sans partie exposant (E), sans arrondir ni modifier l’objet.
Si l’échelle est positive, elle indique le nombre de chiffres après le point décimal : 1.2300 conserve donc ses zéros finaux. Si l’échelle est nulle ou négative, le résultat ne contient pas de point décimal : 1E+3 devient 1000. Le résultat ne dépend pas des paramètres régionaux : le séparateur décimal est un point et les chiffres ne sont pas groupés.
Utilisez cette méthode si vous avez besoin de texte sans exposant. new BigDecimal(text) restitue la même valeur numérique, mais une échelle négative devient 0. Ainsi, compareTo() renvoie 0 même si equals() peut renvoyer false : equals() tient aussi compte de l’échelle. Pour retrouver à la fois la valeur et l’échelle d’origine, utilisez toString(), qui peut employer la notation exponentielle.
Exemples
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));
}
}Résultat
1E+3 1000 1.2300 -0.0000001 -3 -> 0 0 false
Les deux premières lignes comparent `toString()` et `toPlainString()`. Les deux suivantes montrent les zéros finaux et un petit nombre négatif. À la relecture de `1000`, l’échelle passe de `-3` à `0` : la comparaison numérique renvoie `0`, tandis que `equals()` renvoie `false`.
Leçons associées
- Java · Leçon 4 · Débutant · Version : 2
- Java · Leçon 6 · Débutant · Version : 2
- Java · Leçon 69 · Débutant · Version : 2