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