Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

BigDecimal.valueOf — créer des valeurs décimales

Découvrez les trois surcharges de `BigDecimal.valueOf` dans Java 21 et pourquoi la conversion d’un `double` peut différer de l’appel au constructeur.

Version : Java SE 21

Syntaxe

import java.math.BigDecimal;

// Static overloads declared by java.math.BigDecimal:
public static BigDecimal valueOf(long val)
public static BigDecimal valueOf(long unscaledVal, int scale)
public static BigDecimal valueOf(double val)

BigDecimal.valueOf est une méthode de fabrique statique de la classe java.math.BigDecimal. Après import java.math.BigDecimal;, appelez-la sur le nom de la classe, sans new. Java SE 21 propose trois surcharges.

valueOf(long) conserve la valeur entière et fixe l’échelle à 0. valueOf(long unscaledVal, int scale) renvoie la valeur exacte unscaledVal × 10^(−scale) avec l’échelle indiquée. Par exemple, BigDecimal.valueOf(1250L, 2) donne 12.50 avec une échelle de 2. L’échelle peut être négative : BigDecimal.valueOf(125L, -2) a pour valeur numérique 12500 et pour échelle -2.

Pour un double d fini, valueOf(double) donne le même résultat que new BigDecimal(Double.toString(d)) : la méthode utilise la représentation décimale textuelle canonique de d. En revanche, new BigDecimal(d) représente en décimal la valeur binaire exacte stockée dans d. Ainsi, BigDecimal.valueOf(0.1) donne exactement 0.1, tandis que new BigDecimal(0.1) donne une valeur légèrement supérieure. Les deux formes lèvent une NumberFormatException pour NaN et pour les deux infinis.

La conversion ne peut pas récupérer une précision déjà perdue. Dans BigDecimal.valueOf(0.1 + 0.2), l’addition est d’abord effectuée en double, d’où le résultat 0.30000000000000004. Si vous disposez du texte décimal exact, utilisez new BigDecimal("0.1") sans passer par double. Il n’existe pas de surcharge BigDecimal.valueOf(String).

Exemples

import java.math.BigDecimal;

public class Main {
    public static void main(String[] args) {
        double input = 0.1;
        System.out.println(BigDecimal.valueOf(input).toPlainString());
        System.out.println(new BigDecimal(input).toPlainString());
        System.out.println(BigDecimal.valueOf(125L).toPlainString());
        System.out.println(BigDecimal.valueOf(1250L, 2).toPlainString());
        System.out.println(BigDecimal.valueOf(0.1 + 0.2).toPlainString());
    }
}

Résultat

0.1
0.1000000000000000055511151231257827021181583404541015625
125
12.50
0.30000000000000004

Les deux premières lignes comparent la fabrique et le constructeur pour le même `double`. La troisième et la quatrième montrent les surcharges à arguments entiers, et la dernière l’effet d’une addition préalable en `double`. `toPlainString()` renvoie la représentation de la valeur sous forme de texte sans notation exponentielle, et `println` affiche ce texte.

Leçons associées

  • Java · Leçon 4 · Débutant · Version : 2
  • Java · Leçon 6 · Débutant · Version : 2

Sources