ISortedMap Schnittstelle
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.
A Map that also provides a <em>total order</em> 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
- Attribute
- Implementiert
Hinweise
A Map that also provides a <em>total order</em> 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</em> 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 <em>konsistent mit gleich</em> 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</strong>: Mehrere Methoden geben Untermaps mit eingeschränkten Schlüsselbereichen zurück. Solche Bereiche sind <em>halboffen</em>, d. a. der niedrige Endpunkt, aber nicht der hohe Endpunkt (sofern zutreffend). Wenn Sie einen <>geschlossenen Bereich</em> (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></em> 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 |
| JniManagedPeerState |
Status des verwalteten Peers. (Geerbt von IJavaPeerable) |
| JniObjectReferenceControlBlock |
A |
| 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 |
| Compute(Object, IBiFunction) |
Versucht, eine Zuordnung für den angegebenen Schlüssel und den aktuellen zugeordneten Wert (oder |
| ComputeIfAbsent(Object, IFunction) |
Wenn der angegebene Schlüssel noch nicht einem Wert zugeordnet ist (oder diesem zugeordnet |
| 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 |
| ContainsValue(Object) |
Gibt zurück |
| Disposed() |
Wird aufgerufen, wenn die Instanz verworfen wurde. (Geerbt von IJavaPeerable) |
| DisposeUnlessReferenced() |
Wenn keine offenen Verweise auf diese Instanz vorhanden sind, wird nichts aufgerufen |
| EntrySet() |
Gibt eine |
| 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 |
| 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 |
| 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 |
| HeadMap(Object) |
Gibt eine Ansicht des Teils dieser Karte zurück, deren Schlüssel streng kleiner als |
| KeySet() |
Gibt eine |
| LastEntry() |
A |
| 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 |
| PollLastEntry() |
A |
| 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 |
| 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 |
| SequencedKeySet() |
Gibt eine |
| SequencedValues() |
Gibt eine |
| SetJniIdentityHashCode(Int32) |
Legen Sie den von |
| SetJniManagedPeerState(JniManagedPeerStates) |
A |
| SetPeerReference(JniObjectReference) |
Legen Sie den von |
| 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 |
| TailMap(Object) |
Gibt eine Ansicht des Teils dieser Karte zurück, deren Schlüssel größer oder gleich |
| 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 |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| ISequencedMap.PutFirst(Object, Object) |
Löst |
| ISequencedMap.PutLast(Object, Object) |
Löst |
| ISequencedMap.Reversed() |
A |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
A |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |