CKTIS / Java
Number.doubleValue() — konwersja na double
Metoda zwraca wartość obiektu typu `Number` jako prymitywne `double`. Dokładność wyniku zależy od rzeczywistego podtypu obiektu i od tego, czy daną wartość można dokładnie zapisać w typie `double`.
Wersja: Java SE 21
Składnia
public abstract double doubleValue();
// n is a non-null Number reference:
double value = n.doubleValue();Number.doubleValue() to abstrakcyjna metoda instancji bez argumentów, zadeklarowana w java.lang.Number. Wywołanie n.doubleValue() zwraca wartość typu prymitywnego double, a nie obiekt Double. Nawet jeśli zmienna n ma typ Number, Java używa implementacji właściwej dla rzeczywistej klasy obiektu.
Każda wartość Integer jest konwertowana dokładnie, ale niektóre wartości Long wymagają zaokrąglenia. Konwersja BigDecimal może stracić precyzję nawet wtedy, gdy wynik jest skończony, a przy zbyt dużej wartości bezwzględnej może zwrócić nieskończoność o odpowiednim znaku. Jeśli obliczenie ma być dokładne, nie przechodź na double, gdy nie może on dokładnie przedstawić danej wartości.
Jeśli n ma wartość null, wywołanie kończy się wyjątkiem NullPointerException. Metoda konwertuje wartość istniejącego obiektu liczbowego, a nie tekst. Do odczytania liczby z String użyj Double.parseDouble(String).
Przykłady
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);
}
}Wynik
42.0 84.0 9007199254740993 9007199254740992
Pierwsze dwie linie pokazują dokładne `42.0` przed mnożeniem przez `2` oraz wynik `84.0`. Dwie ostatnie porównują pierwotne `long` z wynikiem konwersji na `double` i z powrotem na `long`. Rzutowanie `(long)` pozwala tu wypisać zaokrągloną wartość jako liczbę całkowitą, ale nie odzyskuje utraconej precyzji.
Powiązane lekcje
- Java · Lekcja 9 · Zaawansowany · Wersja: 2
- Java · Lekcja 58 · Podstawowy · Wersja: 2
- Java · Lekcja 59 · Podstawowy · Wersja: 2
Źródła
- 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