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

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

Fontes