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
- Java SE 21 API — Number.doubleValue()
- Java SE 21 API — Integer.doubleValue()
- Java SE 21 API — Long.doubleValue()
- Java SE 21 API — BigDecimal.doubleValue()
- Java SE 21 API — Double.parseDouble(String)
- Java Language Specification, Java SE 21 — §5.1.2 Widening Primitive Conversion
- Java Language Specification, Java SE 21 — §5.1.3 Narrowing Primitive Conversion
- Java Language Specification, Java SE 21 — §15.12.4.4 Locate Method to Invoke