CKTIS / Java
Number.doubleValue() — převod na double
Metoda vrací hodnotu objektu `Number` jako primitivní typ `double`. Přesnost výsledku závisí na skutečném podtypu objektu a na tom, zda lze hodnotu v typu `double` vyjádřit přesně.
Verze: Java SE 21
Syntaxe
public abstract double doubleValue();
// n is a non-null Number reference:
double value = n.doubleValue();Number.doubleValue() je abstraktní instanční metoda bez argumentů, deklarovaná v java.lang.Number. Volání n.doubleValue() vrací hodnotu primitivního typu double, nikoli objekt Double. I když je proměnná n deklarována jako Number, Java použije implementaci skutečné třídy objektu.
Každá hodnota Integer se převede přesně, ale některé hodnoty Long je nutné zaokrouhlit. Při převodu BigDecimal může dojít ke ztrátě přesnosti i u konečného výsledku. Pokud je absolutní hodnota příliš velká, může převod vrátit nekonečno s odpovídajícím znaménkem. Pokud musí být výpočet přesný, nepřecházej na double, jestliže v něm hodnotu nelze vyjádřit přesně.
Pokud je n rovno null, volání vyvolá NullPointerException. Metoda převádí hodnotu existujícího číselného objektu, nikoli text. Pro načtení čísla z String použij Double.parseDouble(String).
Příklady
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);
}
}Výsledek
42.0 84.0 9007199254740993 9007199254740992
První dva řádky ukazují přesnou hodnotu `42.0` před násobením číslem `2` a výsledek `84.0`. Poslední dva porovnávají původní `long` s výsledkem převodu na `double` a zpět na `long`. Přetypování `(long)` zde umožní vypsat zaokrouhlenou hodnotu jako celé číslo, ale neobnoví ztracenou přesnost.
Související lekce
- Java · Lekce 9 · Pokročilá · Verze: 2
- Java · Lekce 58 · Základní · Verze: 2
- Java · Lekce 59 · Základní · Verze: 2
Zdroje
- 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