CKTIS / Java
BigDecimal.compareTo — Dezimalwerte vergleichen
`BigDecimal.compareTo` vergleicht Zahlenwerte unabhängig von Unterschieden in der Skala. Ein Vergleich des Ergebnisses mit null zeigt die Reihenfolge oder numerische Gleichheit.
Version: Java SE 21
Syntax
public int compareTo(BigDecimal val)
// If x and y are BigDecimal values:
x.compareTo(y) < 0 // x is numerically less than y
x.compareTo(y) == 0 // x and y are numerically equal
x.compareTo(y) > 0 // x is numerically greater than yIn Java SE 21 implementiert die Instanzmethode compareTo(BigDecimal val) der Klasse java.math.BigDecimal den Vertrag von Comparable<BigDecimal>. Sie erwartet ein Argument vom Typ BigDecimal; es gibt keine Überladung, die direkt einen double- oder String-Wert annimmt. Bei null als Argument wird eine NullPointerException ausgelöst.
x.compareTo(y) liefert einen int: -1, wenn x numerisch kleiner als y ist, 0 bei gleichen Zahlenwerten oder 1, wenn x größer ist. Vergleiche das Ergebnis mit null, etwa mit x.compareTo(y) < 0 oder x.compareTo(y) == 0. Es ist nicht die Differenz der Zahlen. Der allgemeine Vertrag von Comparable legt nur das Vorzeichen fest; BigDecimal garantiert genau diese drei Rückgabewerte.
Der Vergleich rundet keinen Wert und verändert keines der Objekte. 2.0 und 2.00 haben denselben Zahlenwert, daher liefert compareTo den Wert 0. Ihre Skalen sind aber verschieden (1 und 2), daher liefert equals(Object) den Wert false: Sowohl Zahlenwert als auch Skala müssen übereinstimmen.
== ergibt bei zwei BigDecimal-Referenzen true, wenn sie auf dasselbe Objekt verweisen oder beide null sind. Die Zahlenwerte werden dabei nicht verglichen. Weil die natürliche Ordnung von equals abweicht, behandelt ein TreeSet<BigDecimal> ohne eigenen Komparator 2.0 und 2.00 als ein einziges Element.
Beispiele
import java.math.BigDecimal;
public class Main {
public static void main(String[] args) {
BigDecimal a = new BigDecimal("2.0");
BigDecimal b = new BigDecimal("2.00");
BigDecimal c = new BigDecimal("3.0");
System.out.println(a.compareTo(b));
System.out.println(a.equals(b));
System.out.println(a.compareTo(c));
System.out.println(c.compareTo(a));
}
}
Ergebnis
0 false -1 1
Die als Zeichenketten übergebenen Konstruktorargumente erhalten für `a` und `b` die Skalen `1` und `2`. Die ersten beiden Zeilen zeigen den Unterschied zwischen Zahlenvergleich und `equals`; die letzten beiden zeigen, wie das Vertauschen der Operanden das Vorzeichen ändert.
Zugehörige Lektionen
- Java · Lektion 69 · Grundlagen · Version: 2