IComparable.CompareTo(Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Vergleicht dieses Objekt mit dem angegebenen Objekt für die Reihenfolge.
[Android.Runtime.Register("compareTo", "(Ljava/lang/Object;)I", "GetCompareTo_Ljava_lang_Object_Handler:Java.Lang.IComparableInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public int CompareTo (Java.Lang.Object o);
[<Android.Runtime.Register("compareTo", "(Ljava/lang/Object;)I", "GetCompareTo_Ljava_lang_Object_Handler:Java.Lang.IComparableInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member CompareTo : Java.Lang.Object -> int
Parameter
- o
- Object
das zu vergleichende Objekt.
Gibt zurück
eine negative ganze Zahl, Null oder eine positive ganze Zahl, da dieses Objekt kleiner als, gleich oder größer als das angegebene Objekt ist.
- Attribute
Hinweise
Vergleicht dieses Objekt mit dem angegebenen Objekt für die Reihenfolge. Gibt eine negative ganze Zahl, Null oder eine positive ganze Zahl zurück, da dieses Objekt kleiner als, gleich oder größer als das angegebene Objekt ist.
Der Implementierer muss für alle x
und y
alle sicherstellensgn(x.compareTo(y)) == -sgn(y.compareTo(x))
. (Dies bedeutet, dass x.compareTo(y)
eine Ausnahme ausgelöst werden muss, die y.compareTo(x)
eine Ausnahme auslöst.)
Der Implementierer muss auch sicherstellen, dass die Beziehung transitiv ist: (x.compareTo(y) > 0 && y.compareTo(z) > 0)
impliziert x.compareTo(z) > 0
.
Schließlich muss der Implementierungsor sicherstellen, dass x.compareTo(y)==0
sgn(x.compareTo(z)) == sgn(y.compareTo(z))
, für alle z
.
Es wird dringend empfohlen, aber nicht unbedingt erforderlich, dass (x.compareTo(y)==0) == (x.equals(y))
. Im Allgemeinen sollte jede Klasse, die die Comparable
Schnittstelle implementiert und gegen diese Bedingung verstößt, eindeutig auf diese Tatsache hinweisen. Die empfohlene Sprache lautet "Hinweis: Diese Klasse hat eine natürliche Sortierung, die inkonsistent ist, gleich."
In der vorstehenden Beschreibung bezeichnet der Notationsausdruck sgn(
)
die mathematische Signumfunktion, die definiert ist, um eine von -1
, oder 0
1
je nachdem, ob der Wert des Ausdrucks negativ, null oder positiv ist.
Java-Dokumentation für java.lang.Comparable.compareTo(T)
.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.