CKTIS / Java
Double.compare(): comparar valores double
Compara dois valores primitivos `double` através do sinal do resultado. O método distingue os zeros com sinal e coloca `NaN` no fim da ordem crescente.
Versão: Java SE 21
Sintaxe
public static int compare(double d1, double d2)
int order = Double.compare(a, b);Double.compare() é um método estático de java.lang.Double. A chamada Double.compare(a, b) recebe dois valores primitivos double e devolve um int. Ao contrário do método de instância compareTo(Double), não precisa de um objeto sobre o qual seja invocado. Ambos os métodos usam a mesma ordem.
Verifica o sinal do resultado: um valor negativo indica que a vem antes de b, 0 indica que são iguais segundo esta ordem e um valor positivo indica que a vem depois de b. Não partas do princípio de que um resultado diferente de zero é exatamente -1 ou 1.
O método define uma ordem total. Com exceção de NaN, os valores seguem a ordem numérica habitual com uma diferença: -0.0 vem antes de +0.0, embora == considere iguais estes dois valores primitivos. Todos os valores NaN são considerados iguais entre si na comparação e vêm depois de Double.POSITIVE_INFINITY. Se pelo menos um dos operandos for NaN, os operadores <, <=, >, >= e == sobre valores primitivos devolvem todos false.
Usa este método num comparador quando quiseres ordenar por ordem crescente com base num valor double, de acordo com estas regras. O método não testa a igualdade dentro de uma margem de tolerância.
Exemplos
public class Main {
public static void main(String[] args) {
double nan = Double.NaN;
System.out.println(Integer.signum(Double.compare(2.5, 7.0)));
System.out.println(Double.compare(2.5, 2.5));
System.out.println(Integer.signum(Double.compare(-0.0, +0.0)));
System.out.println(-0.0 == +0.0);
System.out.println(Integer.signum(Double.compare(nan, Double.POSITIVE_INFINITY)));
System.out.println(Double.compare(nan, nan));
System.out.println(nan == nan);
}
}Resultado
-1 0 -1 true 1 0 false
`Integer.signum` reduz o resultado a `-1`, `0` ou `1`. As duas primeiras linhas comparam números comuns, as duas seguintes contrastam a ordem dos zeros com sinal com o resultado de `==`, e as últimas três mostram a posição de `NaN` e como se compara consigo próprio.
Lições relacionadas
- Java · Lição 48 · Básico · Versão: 2
- Java · Lição 5 · Intermédio · Versão: 2