CKTIS / Java
double — números de vírgula flutuante de dupla precisão
double é o tipo primitivo de vírgula flutuante de 64 bits IEEE 754 binary64 do Java. Aprende os seus limites de precisão, a diferença em relação a Double e as regras de comparação, máximo e hash.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
double value = 1.5;
Double boxed = value;
double unboxed = boxed;
int order = Double.compare(value, 2.0);
double maximum = Double.max(value, 2.0);
int hash = Double.hashCode(value);double é a palavra-chave do tipo primitivo IEEE 754 binary64: 64 bits, com 53 bits de precisão da significanda para números normais. Inclui números finitos, +0.0, -0.0, infinitos e NaN. Muitas frações decimais não têm representação binária exata: 0.1 + 0.2 produz 0.30000000000000004. Não pressuponhas exatidão decimal.
Double é a classe wrapper de double. O boxing converte um valor primitivo no respetivo wrapper e o unboxing realiza a conversão inversa. Uma variável Double pode conter null; o unboxing desse valor lança uma NullPointerException. Um double primitivo não pode conter null.
Double.compare(a, b) devolve um inteiro negativo, zero ou um inteiro positivo, de acordo com a ordem dos argumentos. Ordena -0.0 antes de +0.0 e considera todos os valores NaN iguais entre si e superiores ao infinito positivo. Em contrapartida, o operador primitivo == considera os dois zeros iguais, mas não considera NaN igual nem a si próprio.
Double.max(a, b) comporta-se como Math.max: devolve o valor maior, devolve NaN se algum argumento for NaN e devolve +0.0 para zeros com sinais opostos. Double.hashCode(value) devolve um hash do tipo int, compatível com o método de instância Double.hashCode(): todas as representações de NaN têm o mesmo hash, enquanto os dois zeros têm hashes diferentes. Um hash não é um identificador único.
Exemplos
public class DoubleDemo {
public static void main(String[] args) {
double sum = 0.1 + 0.2;
Double boxed = sum;
System.out.println(boxed);
System.out.println(-0.0 == 0.0);
System.out.println(Double.compare(-0.0, 0.0) < 0);
System.out.println(Double.compare(Double.NaN, Double.NaN) == 0);
System.out.println(Double.max(-0.0, 0.0));
System.out.println(Double.max(1.0, Double.NaN));
System.out.println(Double.hashCode(0.0));
System.out.println(Double.hashCode(-0.0));
}
}Resultado
0.30000000000000004 true true true 0.0 NaN 0 -2147483648
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.
Fontes
- Overview (Java SE 21 & JDK 21)
- Java Language Specification, Java SE 21 — §3.9 Keywords
- Double (Java SE 21 & JDK 21)
- Java Language Specification, Java SE 21 — §4.2.3 Floating-Point Types and Values
- Math (Java SE 21 & JDK 21) — max(double, double)
- Java Language Specification, Java SE 21 — §5.1.8 Unboxing Conversion
- Official reference — docs.oracle.com: lang / Double.html