Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Number.doubleValue() — converter para double

O método devolve o valor de um objeto `Number` como um `double` primitivo. A exatidão depende do subtipo real do objeto e de o valor poder ser representado exatamente como `double`.

Versão: Java SE 21

Sintaxe

public abstract double doubleValue();
// n is a non-null Number reference:
double value = n.doubleValue();

Number.doubleValue() é um método de instância abstrato, sem argumentos, declarado em java.lang.Number. A chamada n.doubleValue() devolve um valor do tipo primitivo double, não um objeto Double. Mesmo quando n é declarado como Number, o Java usa a implementação da classe real do objeto.

Todos os valores Integer são convertidos com exatidão, mas alguns valores Long têm de ser arredondados. A conversão de um BigDecimal pode perder precisão mesmo quando o resultado é finito e pode devolver um infinito com o sinal adequado se o valor absoluto for demasiado grande. Se o cálculo tiver de ser exato, não passes para double quando este tipo não puder representar o valor exatamente.

Se n for null, a chamada lança uma NullPointerException. O método converte o valor de um objeto numérico existente; não interpreta texto. Para ler um número a partir de uma String, usa Double.parseDouble(String).

Exemplos

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);
    }
}

Resultado

42.0
84.0
9007199254740993
9007199254740992

As duas primeiras linhas mostram o valor exato `42.0` antes da multiplicação por `2` e o resultado `84.0`. As duas últimas comparam o `long` original com o resultado da conversão para `double` e de volta para `long`. A conversão explícita `(long)` permite apresentar aqui o valor arredondado como um inteiro, mas não recupera a precisão perdida.

Lições relacionadas

  • Java · Lição 9 · Avançado · Versão: 2
  • Java · Lição 58 · Básico · Versão: 2
  • Java · Lição 59 · Básico · Versão: 2

Fontes