Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Double.compare(): confrontare valori double

Confronta due valori primitivi `double` leggendo il segno del risultato. Il metodo distingue gli zeri con segno e colloca `NaN` alla fine dell’ordinamento crescente.

Versione: Java SE 21

Sintassi

public static int compare(double d1, double d2)

int order = Double.compare(a, b);

Double.compare() è un metodo statico di java.lang.Double. La chiamata Double.compare(a, b) riceve due valori primitivi double e restituisce un int. A differenza del metodo di istanza compareTo(Double), non richiede un oggetto su cui essere invocato. I due metodi usano lo stesso ordinamento.

Controlla il segno del risultato: un valore negativo indica che a precede b, 0 indica che sono uguali secondo questo ordinamento e un valore positivo indica che a segue b. Non dare per scontato che un risultato diverso da zero valga esattamente -1 o 1.

Il metodo definisce un ordine totale. A parte NaN, i valori seguono il normale ordine numerico con una differenza: -0.0 precede +0.0, anche se == considera uguali questi due valori primitivi. Tutti i valori NaN risultano uguali tra loro nel confronto e seguono Double.POSITIVE_INFINITY. Se almeno un operando è NaN, gli operatori <, <=, >, >= e == sui valori primitivi restituiscono tutti false.

Usa questo metodo in un comparatore per ordinare in modo crescente in base a un valore double secondo queste regole. Il metodo non verifica l’uguaglianza entro una tolleranza.

Esempi

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

Risultato

-1
0
-1
true
1
0
false

`Integer.signum` riduce il risultato a `-1`, `0` o `1`. Le prime due righe confrontano numeri ordinari, le due successive mettono a confronto l’ordine degli zeri con segno e il risultato di `==`, e le ultime tre mostrano la posizione di `NaN` e il suo confronto con sé stesso.

Lezioni correlate

  • Java · Lezione 48 · Base · Versione: 2
  • Java · Lezione 5 · Intermedio · Versione: 2

Fonti