IComparator Schnittstelle

Definition

[Android.Runtime.Register("java/util/Comparator", "", "Java.Util.IComparatorInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public interface IComparator : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("java/util/Comparator", "", "Java.Util.IComparatorInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
type IComparator = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Abgeleitet

Android.Content.PM.ApplicationInfo.DisplayNameComparator

Android.Content.PM.PackageItemInfo.DisplayNameComparator

Android.Content.PM.ResolveInfo.DisplayNameComparator

Android.Icu.Text.Collator

Java.Text.Collator

Attribute

RegisterAttribute JavaTypeParametersAttribute

Implementiert

IJavaObject IJavaPeerable IDisposable

Hinweise

Eine Vergleichsfunktion, die eine Gesamtaufordnung für eine Sammlung von Objekten aufzwingt. Vergleiche können an eine Sortiermethode (z Collections#sort(List,Comparator) Collections.sort . B. oder Arrays#sort(Object[],Comparator) Arrays.sort) übergeben werden, um eine präzise Kontrolle über die Sortierreihenfolge zu ermöglichen. Vergleiche können auch verwendet werden, um die Reihenfolge bestimmter Datenstrukturen (z. B. sortierte Sätze oder sortierte SortedMap-Zuordnungen) zu steuern oder eine Sortierreihenfolge für Auflistungen von Objekten bereitzustellen, die keine vergleichbare natürliche Sortierung aufweisen.

Die Reihenfolge, die von einem Vergleichszeichen c für eine Gruppe von Elementen S auferlegt wird, ist mit gleich, wenn und nur, wenn c.compare(e1, e2)==0 derselbe boolesche Wert wie e1.equals(e2) für jedes e1 und e2 in S.

Vorsicht sollte bei Verwendung eines Vergleichsgebers ausgeführt werden, der eine Sortierung inkonsistent mit der Reihenfolge eines sortierten Satzes (oder einer sortierten Karte) anordnen kann. Angenommen, ein sortierter Satz (oder eine sortierte Karte) mit einem expliziten Vergleich c wird mit Elementen (oder Tasten) verwendet, die aus einer Gruppe Sgezeichnet werden. Wenn die sortierung, die von c "on S " auferlegt wird, gleich ist, verhält sich der sortierte Satz (oder die sortierte Karte) "seltsam". Insbesondere wird der sortierte Satz (oder die sortierte Karte) gegen den allgemeinen Vertrag für Set (oder Karte) verstoßen, der in Bezug auf equals.

Angenommen, man fügt zwei Elemente a hinzu und b fügt eine leere (a.equals(b) && c.compare(a, b) != 0)TreeSet mit Vergleichszeichen chinzu. Der zweite add Vorgang gibt "true" (und die Größe des Baumsatzes wird vergrößert) zurück, da a er b aus Sicht des Baumsatzes nicht gleichwertig ist, obwohl dies der Spezifikation der Set#add Set.add Methode widerspricht.

Hinweis: Im Allgemeinen empfiehlt es sich, Vergleiche zu implementieren java.io.Serializable, da sie als Sortiermethoden in serialisierbaren Datenstrukturen (z TreeSet. B. , TreeMap) verwendet werden können. Damit die Datenstruktur erfolgreich serialisiert werden kann, muss der Vergleichsator (sofern angegeben) implementiert werden Serializable.

Für die mathematisch geneigte Beziehung, die die auferlegte Reihenfolge definiert, die ein bestimmter Vergleichssatz c für eine bestimmte Gruppe von Objekten S aufzwingt, lautet:

{(x, y) such that c.compare(x, y) <= 0}.

Der Quotient für diese Gesamtbestellung lautet:

{(x, y) such that c.compare(x, y) == 0}.

Es folgt unmittelbar aus dem Vertrag dafürcompare, dass der Quotient eine Äquivalenzbeziehung S ist und dass die auferlegte Bestellung eine Gesamtbestellung ist.S Wenn wir sagen, dass die sortierung, die von c on S auferlegt wird, gleich ist, meinen wir, dass der Quotient für die Sortierung die Äquivalenzbeziehung ist, die durch die Methode(n) Object#equals(Object) equals(Object) der Objekte definiert wird:

{(x, y) such that x.equals(y)}.

Anders ausgedrückt: Wenn die auferlegte Sortierung gleich ist, sind die Äquivalenzklassen, die durch die Äquivalenzbeziehung der equals Methode und die durch den Quotienten der compare Methode definierten Äquivalenzklassen definiert sind, identisch.

Im Gegensatz dazu Comparablekann ein Vergleich optional einen Vergleich von Nullargumenten zulassen und gleichzeitig die Anforderungen für eine Äquivalenzbeziehung beibehalten.

Diese Schnittstelle ist ein Mitglied des Java Collections Framework.

In 1.2 hinzugefügt.

Java-Dokumentation für java.util.Comparator.

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.

Eigenschaften

Methoden

Erweiterungsmethoden

Gilt für: