CKTIS / Java
Number.doubleValue() — in double umwandeln
Die Methode liefert den Wert eines `Number`-Objekts als primitiven `double`. Ob das Ergebnis exakt ist, hängt vom tatsächlichen Untertyp des Objekts und davon ab, ob der Wert als `double` darstellbar ist.
Version: Java SE 21
Syntax
public abstract double doubleValue();
// n is a non-null Number reference:
double value = n.doubleValue();Number.doubleValue() ist eine abstrakte Instanzmethode ohne Argumente, die in java.lang.Number deklariert ist. Der Aufruf n.doubleValue() liefert einen Wert vom primitiven Typ double, kein Double-Objekt. Auch wenn n als Number deklariert ist, verwendet Java die Implementierung der tatsächlichen Klasse des Objekts.
Jeder Integer-Wert wird exakt umgewandelt, manche Long-Werte müssen dagegen gerundet werden. Bei BigDecimal kann selbst ein endliches Ergebnis an Genauigkeit verlieren. Ist der Betrag zu groß, kann die Umwandlung Unendlichkeit mit dem passenden Vorzeichen liefern. Wenn eine Berechnung exakt sein muss, verwende keinen double, der den betreffenden Wert nicht exakt darstellen kann.
Ist n gleich null, löst der Aufruf eine NullPointerException aus. Die Methode wandelt den Wert eines vorhandenen numerischen Objekts um und liest keinen Text ein. Um eine Zahl aus einem String zu lesen, verwende Double.parseDouble(String).
Beispiele
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);
}
}Ergebnis
42.0 84.0 9007199254740993 9007199254740992
Die ersten beiden Zeilen zeigen den exakten Wert `42.0` vor der Multiplikation mit `2` und das Ergebnis `84.0`. Die letzten beiden vergleichen den ursprünglichen `long`-Wert mit dem Ergebnis der Umwandlung in `double` und zurück in `long`. Die Umwandlung mit `(long)` gibt den gerundeten Wert hier als ganze Zahl aus, stellt aber keine verlorene Genauigkeit wieder her.
Zugehörige Lektionen
- Java · Lektion 9 · Fortgeschritten · Version: 2
- Java · Lektion 58 · Grundlagen · Version: 2
- Java · Lektion 59 · Grundlagen · Version: 2
Quellen
- 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