WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Double.compare(): double-Werte vergleichen

Vergleiche zwei primitive `double`-Werte anhand des Vorzeichens des Ergebnisses. Die Methode unterscheidet die beiden Nullen mit Vorzeichen und ordnet `NaN` aufsteigend ganz hinten ein.

Version: Java SE 21

Syntax

public static int compare(double d1, double d2)

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

Double.compare() ist eine statische Methode von java.lang.Double. Der Aufruf Double.compare(a, b) nimmt zwei primitive double-Werte entgegen und liefert ein int. Anders als die Instanzmethode compareTo(Double) benötigt sie kein Objekt, auf dem sie aufgerufen wird. Beide Methoden verwenden dieselbe Ordnung.

Prüfe das Vorzeichen des Ergebnisses: Ein negativer Wert bedeutet, dass a vor b steht, 0 bedeutet Gleichheit in dieser Ordnung, und ein positiver Wert bedeutet, dass a nach b steht. Verlasse dich nicht darauf, dass ein Ergebnis ungleich null genau -1 oder 1 ist.

Die Methode definiert eine totale Ordnung. Abgesehen von NaN gilt die übliche numerische Ordnung mit einem Unterschied: -0.0 steht vor +0.0, obwohl == die beiden primitiven Werte als gleich behandelt. Alle NaN-Werte gelten beim Vergleich als gleich und stehen nach Double.POSITIVE_INFINITY. Ist mindestens ein Operand NaN, liefern die Operatoren <, <=, >, >= und == für primitive Werte jeweils false.

Verwende die Methode in einem Komparator, wenn du nach einem double-Wert mit diesen Regeln aufsteigend sortieren möchtest. Die Methode prüft nicht auf Gleichheit innerhalb einer Toleranz.

Beispiele

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

Ergebnis

-1
0
-1
true
1
0
false

`Integer.signum` bildet das Ergebnis auf `-1`, `0` oder `1` ab. Die ersten beiden Zeilen vergleichen gewöhnliche Zahlen. Die nächsten beiden stellen die Reihenfolge der Nullen mit Vorzeichen dem Ergebnis von `==` gegenüber. Die letzten drei zeigen die Position von `NaN` und den Vergleich von `NaN` mit sich selbst.

Zugehörige Lektionen

  • Java · Lektion 48 · Grundlagen · Version: 2
  • Java · Lektion 5 · Mittlere Stufe · Version: 2

Quellen