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

CKTIS / Java

Number.doubleValue() — convertir en double

La méthode renvoie la valeur d’un objet `Number` sous forme de `double` primitif. L’exactitude dépend du sous-type réel de l’objet et de la possibilité de représenter exactement la valeur en `double`.

Version : Java SE 21

Syntaxe

public abstract double doubleValue();
// n is a non-null Number reference:
double value = n.doubleValue();

Number.doubleValue() est une méthode d’instance abstraite sans argument, déclarée dans java.lang.Number. L’appel n.doubleValue() renvoie une valeur primitive de type double, et non un objet Double. Même si n est déclaré de type Number, Java utilise l’implémentation de la classe réelle de l’objet.

Toute valeur Integer est convertie exactement, mais certaines valeurs Long doivent être arrondies. La conversion d’un BigDecimal peut perdre en précision même si le résultat est fini, et elle peut renvoyer un infini du signe approprié si la valeur absolue est trop grande. Si le calcul doit rester exact, ne passez pas à double quand ce type ne peut pas représenter exactement la valeur.

Si n vaut null, l’appel lève une NullPointerException. La méthode convertit la valeur d’un objet numérique existant ; elle n’analyse pas de texte. Pour lire un nombre à partir d’un String, utilisez Double.parseDouble(String).

Exemples

public class NumberDoubleValueDemo {
    public static void main(String[] args) {
        Number small = Integer.valueOf(42);
        double value = small.doubleValue();
        System.out.println(value);
        System.out.println(value * 2);

        long original = 9_007_199_254_740_993L;
        Number large = Long.valueOf(original);
        double rounded = large.doubleValue();
        System.out.println(original);
        System.out.println((long) rounded);
    }
}

Résultat

42.0
84.0
9007199254740993
9007199254740992

Les deux premières lignes affichent `42.0` exactement avant la multiplication par `2`, puis le résultat `84.0`. Les deux dernières comparent le `long` d’origine avec le résultat de la conversion en `double`, puis à nouveau en `long`. La conversion explicite `(long)` permet ici d’afficher la valeur arrondie sous forme d’entier, sans récupérer la précision perdue.

Leçons associées

  • Java · Leçon 9 · Avancé · Version : 2
  • Java · Leçon 58 · Débutant · Version : 2
  • Java · Leçon 59 · Débutant · Version : 2

Sources