Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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