CKTIS / Java
Number.doubleValue() — omzetten naar double
Deze methode geeft de waarde van een `Number`-object terug als een primitieve `double`. Of de uitkomst exact is, hangt af van het werkelijke subtype en van de waarden die `double` exact kan voorstellen.
Versie: Java SE 21
Syntax
public abstract double doubleValue();
// n is a non-null Number reference:
double value = n.doubleValue();Number.doubleValue() is een abstracte instantiemethode zonder argumenten, gedeclareerd in java.lang.Number. De aanroep n.doubleValue() geeft een primitieve double terug, geen Double-object. Ook als n als Number is gedeclareerd, gebruikt Java de implementatie van de werkelijke klasse van het object.
Elke Integer-waarde wordt exact omgezet, maar sommige Long-waarden moeten worden afgerond. Bij omzetting van een BigDecimal kan precisie verloren gaan, zelfs als het resultaat eindig is. Als de absolute waarde te groot is, kan de omzetting positieve of negatieve oneindigheid opleveren, afhankelijk van het teken. Moet een berekening exact zijn, stap dan niet over op double als dat type de waarde niet exact kan voorstellen.
Als n gelijk is aan null, veroorzaakt de aanroep een NullPointerException. De methode zet de waarde van een bestaand numeriek object om en leest geen tekst. Gebruik Double.parseDouble(String) om een getal uit een String te lezen.
Voorbeelden
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);
}
}Resultaat
42.0 84.0 9007199254740993 9007199254740992
De eerste twee regels tonen de exacte waarde `42.0` vóór de vermenigvuldiging met `2` en de uitkomst `84.0`. De laatste twee vergelijken de oorspronkelijke `long` met de uitkomst na omzetting naar `double` en terug naar `long`. Met de cast `(long)` druk je de afgeronde waarde hier af als geheel getal; verloren precisie komt niet terug.
Gerelateerde lessen
- Java · Les 9 · Gevorderd · Versie: 2
- Java · Les 58 · Basis · Versie: 2
- Java · Les 59 · Basis · Versie: 2
Bronnen
- 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