ISortedMap Schnittstelle

Definition

Namespace:: Java.Util

Assembly:: Mono.Android.dll

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.

A Map that also provides a total order on its keys.

[Android.Runtime.Register("java/util/SortedMap", "", "Java.Util.ISortedMapInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public interface ISortedMap : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ISequencedMap

[<Android.Runtime.Register("java/util/SortedMap", "", "Java.Util.ISortedMapInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type ISortedMap = interface
    interface IMap
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ISequencedMap

Abgeleitet: Java.Util.INavigableMap

Java.Util.TreeMap

Attribute: RegisterAttribute JavaTypeParametersAttribute

Implementiert: IJavaObject IJavaPeerable IMap ISequencedMap IDisposable

Hinweise

A Map that also provides a total order on its keys. Die Karte wird nach der vergleichbaren natürlichen Reihenfolge ihrer Schlüssel oder durch eine in der Comparator Regel zur sortierten Kartenerstellungszeit bereitgestellte Reihenfolge sortiert. Diese Reihenfolge wird beim Durchlaufen der Sammlungsansichten der sortierten Zuordnung (zurückgegeben durch die entrySetMethoden keySet ) values widergespiegelt. Es werden mehrere zusätzliche Vorgänge bereitgestellt, um die Bestellung zu nutzen. (Diese Schnittstelle ist das Karten analog zu SortedSet.)

Alle in eine sortierte Zuordnung eingefügten Schlüssel müssen die Comparable Schnittstelle implementieren (oder vom angegebenen Vergleichszeichen akzeptiert werden). Darüber hinaus müssen alle diese Schlüssel sich gegenseitig vergleichbar sein><: k1.compareTo(k2) (oder comparator.compare(k1, k2)) dürfen keine Schlüssel k1 und k2 in der sortierten Karte auslösenClassCastException. Versuche, gegen diese Einschränkung zu verstoßen, führen dazu, dass die fehlerhafte Methode oder der Konstruktoraufruf ausgelöst wird ClassCastException.

Beachten Sie, dass die Sortierung, die von einer sortierten Karte verwaltet wird (unabhängig davon, ob ein expliziter Vergleich bereitgestellt wird) gleich/em> konsistent sein <>muss, wenn die sortierte Karte die Map Schnittstelle korrekt implementiert.< (Eine genaue Definition von konsistent mit gleich finden Sie in der Comparable Schnittstelle oder Comparator Schnittstelle.) Dies liegt daran, dass die Map Schnittstelle in Bezug auf den equals Vorgang definiert ist, aber eine sortierte Zuordnung führt alle Schlüsselvergleiche mithilfe ihrer compareTo (oder compare) Methode aus, sodass zwei Schlüssel, die von dieser Methode als gleich eingestuft werden, aus der Sicht der sortierten Zuordnung gleich sind. Das Verhalten einer Strukturzuordnung em ist/em> gut definiert, auch wenn die Sortierung inkonsistent ist und gleich ist; sie unterliegt nur dem allgemeinen Vertrag der Map Schnittstelle.<><

Alle allgemeinen, sortierten Kartenimplementierungsklassen sollten vier "Standard"-Konstruktoren bereitstellen. Es ist nicht möglich, diese Empfehlung zu erzwingen, da erforderliche Konstruktoren nicht durch Schnittstellen angegeben werden können. Die erwarteten "Standard"-Konstruktoren für alle sortierten Kartenimplementierungen sind: <ol<>li>A void (no arguments) constructor, which creates an empty sorted map sorted to the natural order of its keys.</li><>Li A-Konstruktor mit einem einzigen Argument vom Typ Comparator, wodurch eine leere sortierte Zuordnung nach dem angegebenen Vergleichszeichen sortiert wird.</li li>><A-Konstruktor mit einem einzigen Argument vom Typ Map, der eine neue Karte mit denselben Schlüsselwertzuordnungen wie ihr Argument erstellt, sortiert nach der natürlichen Reihenfolge der Schlüssel.</li><>Li A-Konstruktor mit einem einzelnen Argument vom Typ SortedMap, wodurch eine neue sortierte Zuordnung mit denselben Schlüsselwertzuordnungen und der gleichen Reihenfolge wie die eingegebene sortierte Zuordnung erstellt wird.</li></ol>

<starke>Note: Mehrere Methoden geben Untermaps mit eingeschränkten Schlüsselbereichen zurück. Solche Bereiche sind halboffen, d. a. der niedrige Endpunkt, aber nicht der hohe Endpunkt (sofern zutreffend). Wenn Sie einen <>geschlossenen Bereich (der beide Endpunkte enthält) benötigen und der Schlüsseltyp die Berechnung des Nachfolgers eines bestimmten Schlüssels zulässt, fordern Sie lediglich den Unterbereich von lowEndpoint bis zu .successor(highEndpoint) Angenommen, es m handelt sich um eine Zuordnung, deren Schlüssel Zeichenfolgen sind. Mit dem folgenden Idiom wird eine Ansicht abgerufen, die alle Schlüsselwertzuordnungen enthält, deren m Schlüssel zwischen low und higheinschließlich sind:

SortedMap<String, V> sub = m.subMap(low, high+"\0");

Eine ähnliche Technik kann verwendet werden, um einen <geöffneten Em-Bereich> zu generieren (der keine endpunkte enthält). Der folgende Idiom ruft eine Ansicht ab, die alle Schlüsselwertzuordnungen enthält, deren m Schlüssel zwischen low und high, exklusiv sind:

SortedMap<String, V> sub = m.subMap(low+"\0", high);

Diese Schnittstelle ist ein Mitglied des Java Collections Framework.

In 1.2 hinzugefügt.

Java Dokumentation für java.util.SortedMap.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Eigenschaften

Name	Beschreibung
Handle	Ruft den JNI-Wert des zugrunde liegenden Android-Objekts ab. (Geerbt von IJavaObject)
IsEmpty	Gibt zurück, ob diese Karte leer ist. (Geerbt von IMap)
JniIdentityHashCode	Gibt den Wert `java.lang.System.identityHashCode()` für die umbrochene Instanz zurück. (Geerbt von IJavaPeerable)
JniManagedPeerState	Status des verwalteten Peers. (Geerbt von IJavaPeerable)
JniObjectReferenceControlBlock	A `Map` that also provides a <em>total order</em> on its keys. (Geerbt von IJavaPeerable)
JniPeerMembers	Mitgliedszugriff und Aufrufunterstützung. (Geerbt von IJavaPeerable)
PeerReference	Gibt eine JniObjectReference der umbrochenen Java Objektinstanz zurück. (Geerbt von IJavaPeerable)

Methoden

Name	Beschreibung
Clear()	Entfernt alle Zuordnungen aus dieser Karte (optionaler Vorgang). (Geerbt von IMap)
Comparator()	Gibt den Vergleichsator zurück, der verwendet wird, um die Schlüssel in dieser Karte zu sortieren, oder `null` wenn diese Karte die vergleichbare natürliche Reihenfolge ihrer Schlüssel verwendet.
Compute(Object, IBiFunction)	Versucht, eine Zuordnung für den angegebenen Schlüssel und den aktuellen zugeordneten Wert (oder `null` wenn keine aktuelle Zuordnung vorhanden ist) zu berechnen. (Geerbt von IMap)
ComputeIfAbsent(Object, IFunction)	Wenn der angegebene Schlüssel noch nicht einem Wert zugeordnet ist (oder diesem zugeordnet `null`ist), versucht, seinen Wert mithilfe der angegebenen Zuordnungsfunktion zu berechnen und es in diese Karte einzugeben, es sei denn `null`. (Geerbt von IMap)
ComputeIfPresent(Object, IBiFunction)	Wenn der Wert für den angegebenen Schlüssel vorhanden und nicht null ist, wird versucht, eine neue Zuordnung anhand des Schlüssels und des aktuellen zugeordneten Werts zu berechnen. (Geerbt von IMap)
ContainsKey(Object)	Gibt zurück `true` , wenn diese Zuordnung eine Zuordnung für den angegebenen Schlüssel enthält. (Geerbt von IMap)
ContainsValue(Object)	Gibt zurück `true` , wenn diese Karte einem oder mehreren Schlüsseln den angegebenen Wert zuordnet. (Geerbt von IMap)
Disposed()	Wird aufgerufen, wenn die Instanz verworfen wurde. (Geerbt von IJavaPeerable)
DisposeUnlessReferenced()	Wenn keine offenen Verweise auf diese Instanz vorhanden sind, wird nichts aufgerufen `Dispose()`. Andernfalls wird nichts ausgeführt. (Geerbt von IJavaPeerable)
EntrySet()	Gibt eine `Set` Ansicht der In dieser Karte enthaltenen Zuordnungen zurück.
Equals(Object)	Vergleicht das angegebene Objekt mit dieser Zuordnung für die Gleichheit. (Geerbt von IMap)
Finalized()	Wird aufgerufen, wenn die Instanz abgeschlossen wurde. (Geerbt von IJavaPeerable)
FirstEntry()	A `Map` that also provides a <em>total order</em> on its keys. (Geerbt von ISequencedMap)
FirstKey()	Gibt den ersten (niedrigsten) Schlüssel zurück, der sich derzeit in dieser Karte befindet.
ForEach(IBiConsumer)	Führt die angegebene Aktion für jeden Eintrag in dieser Zuordnung aus, bis alle Einträge verarbeitet wurden oder die Aktion eine Ausnahme auslöst. (Geerbt von IMap)
Get(Object)	Gibt den Wert zurück, dem der angegebene Schlüssel zugeordnet wird oder `null` wenn diese Zuordnung keine Zuordnung für den Schlüssel enthält. (Geerbt von IMap)
GetHashCode()	Gibt den Hashcodewert für diese Zuordnung zurück. (Geerbt von IMap)
GetOrDefault(Object, Object)	Gibt den Wert zurück, dem der angegebene Schlüssel zugeordnet wird oder `defaultValue` wenn diese Zuordnung keine Zuordnung für den Schlüssel enthält. (Geerbt von IMap)
HeadMap(Object)	Gibt eine Ansicht des Teils dieser Karte zurück, deren Schlüssel streng kleiner als `toKey`sind.
KeySet()	Gibt eine `Set` Ansicht der in dieser Karte enthaltenen Schlüssel zurück.
LastEntry()	A `Map` that also provides a <em>total order</em> on its keys. (Geerbt von ISequencedMap)
LastKey()	Gibt den letzten (höchsten) Schlüssel zurück, der sich derzeit in dieser Karte befindet.
Merge(Object, Object, IBiFunction)	Wenn der angegebene Schlüssel noch nicht einem Wert zugeordnet ist oder null zugeordnet ist, ordnet er dem angegebenen Wert ungleich Null zu. (Geerbt von IMap)
PollFirstEntry()	A `Map` that also provides a <em>total order</em> on its keys. (Geerbt von ISequencedMap)
PollLastEntry()	A `Map` that also provides a <em>total order</em> on its keys. (Geerbt von ISequencedMap)
Put(Object, Object)	Ordnet den angegebenen Wert dem angegebenen Schlüssel in dieser Karte zu (optionaler Vorgang). (Geerbt von IMap)
PutAll(IDictionary)	Kopiert alle Zuordnungen aus der angegebenen Zuordnung in diese Karte (optionaler Vorgang). (Geerbt von IMap)
PutFirst(Object, Object)	Fügt die angegebene Zuordnung in die Karte ein, wenn sie noch nicht vorhanden ist, oder ersetzt den Wert einer Zuordnung, wenn sie bereits vorhanden ist (optionaler Vorgang). (Geerbt von ISequencedMap)
PutIfAbsent(Object, Object)	Wenn der angegebene Schlüssel noch nicht einem Wert zugeordnet ist (oder diesem zugeordnet ist), wird er dem angegebenen Wert zugeordnet `null`und zurückgegeben `null`, andernfalls wird der aktuelle Wert zurückgegeben. (Geerbt von IMap)
PutLast(Object, Object)	Fügt die angegebene Zuordnung in die Karte ein, wenn sie noch nicht vorhanden ist, oder ersetzt den Wert einer Zuordnung, wenn sie bereits vorhanden ist (optionaler Vorgang). (Geerbt von ISequencedMap)
Remove(Object, Object)	Entfernt den Eintrag für den angegebenen Schlüssel nur, wenn er derzeit dem angegebenen Wert zugeordnet ist. (Geerbt von IMap)
Remove(Object)	Entfernt die Zuordnung für einen Schlüssel aus dieser Karte, wenn er vorhanden ist (optionaler Vorgang). (Geerbt von IMap)
Replace(Object, Object, Object)	Ersetzt den Eintrag für den angegebenen Schlüssel nur, wenn er derzeit dem angegebenen Wert zugeordnet ist. (Geerbt von IMap)
Replace(Object, Object)	Ersetzt den Eintrag für den angegebenen Schlüssel nur, wenn er derzeit einem Bestimmten Wert zugeordnet ist. (Geerbt von IMap)
ReplaceAll(IBiFunction)	Ersetzt den Wert jedes Eintrags durch das Ergebnis, dass die angegebene Funktion für diesen Eintrag aufgerufen wird, bis alle Einträge verarbeitet wurden oder die Funktion eine Ausnahme auslöst. (Geerbt von IMap)
Reversed()	Gibt eine umgekehrte Ansicht dieser Karte zurück. (Geerbt von ISequencedMap)
SequencedEntrySet()	Gibt eine `SequencedSet` Ansicht der Karte zurück `#entrySet entrySet`. (Geerbt von ISequencedMap)
SequencedKeySet()	Gibt eine `SequencedSet` Ansicht der Karte zurück `#keySet keySet`. (Geerbt von ISequencedMap)
SequencedValues()	Gibt eine `SequencedCollection` Ansicht der Auflistung dieser Karte `#values values` zurück. (Geerbt von ISequencedMap)
SetJniIdentityHashCode(Int32)	Legen Sie den von `JniIdentityHashCode`. (Geerbt von IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	A `Map` that also provides a <em>total order</em> on its keys. (Geerbt von IJavaPeerable)
SetPeerReference(JniObjectReference)	Legen Sie den von `PeerReference`. (Geerbt von IJavaPeerable)
Size()	Gibt die Anzahl der Schlüsselwertzuordnungen in dieser Karte zurück. (Geerbt von IMap)
SubMap(Object, Object)	Gibt eine Ansicht des Teils dieser Karte zurück, deren Schlüssel von `fromKey`einschließlich bis exklusiv `toKey`reichen.
TailMap(Object)	Gibt eine Ansicht des Teils dieser Karte zurück, deren Schlüssel größer oder gleich `fromKey`sind.
UnregisterFromRuntime()	Heben Sie die Registrierung dieser Instanz auf, damit die Laufzeit sie nicht aus zukünftigen Java.Interop.JniRuntime+JniValueManager.PeekValue Aufrufen zurückgibt. (Geerbt von IJavaPeerable)
Values()	Gibt eine `Collection` Ansicht der in dieser Karte enthaltenen Werte zurück.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
ISequencedMap.PutFirst(Object, Object)	Löst `UnsupportedOperationException` aus.
ISequencedMap.PutLast(Object, Object)	Löst `UnsupportedOperationException` aus.
ISequencedMap.Reversed()	A `Map` that also provides a <em>total order</em> on its keys.

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	A `Map` that also provides a <em>total order</em> on its keys.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: