Freigeben über


IComparable.CompareTo(Object) Methode

Definition

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 yalle 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)==0sgn(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 01 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.

Gilt für: