ISortedMap Interface

Définition

Espace de noms:: Java.Util

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Qui Map fournit également un <ordre> total em sur ses clés.

[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

Dérivé: Java.Util.INavigableMap

Java.Util.TreeMap

Attributs: RegisterAttribute JavaTypeParametersAttribute

Implémente: IJavaObject IJavaPeerable IMap ISequencedMap IDisposable

Remarques

Qui Map fournit également un <ordre> total em sur ses clés. La carte est triée selon l’ordre naturel comparable de ses clés, ou par un Comparator temps de création de carte trié. Cet ordre est reflété lors de l’itération sur les vues de collection triées de la carte (retournées par les méthodes et values les entrySetkeySet méthodes). Plusieurs opérations supplémentaires sont fournies pour tirer parti de l’ordre. (Cette interface est l’analogue de la carte de SortedSet.)

Toutes les clés insérées dans une carte triée doivent implémenter l’interface Comparable (ou être acceptées par le comparateur spécifié). De plus, toutes ces clés doivent être <>mutuellement comparables : k1.compareTo(k2) (ou comparator.compare(k1, k2)) ne doivent pas lever de ClassCastException clés k1 et k2 dans la carte triée. Les tentatives de violation de cette restriction entraînent l’appel de la méthode ou du constructeur incriminé pour lever un ClassCastException.

Notez que l’ordre géré par une carte triée (qu’un comparateur explicite soit fourni) doit être <>cohérent avec les valeurs égales si la carte triée doit implémenter correctement l’interfaceMap. (Consultez l’interface ou l’interface Comparable pour obtenir une définition précise d’em>< cohérente avec equals.)Comparator Cela est dû au fait que l’interface Map est définie en termes d’opérationequals, mais qu’une carte triée effectue toutes les comparaisons de clés à l’aide de sa compareTo méthode (oucompare), donc deux clés considérées comme égales par cette méthode sont, du point de vue de la carte triée, égales. Le comportement d’une carte <d’arborescence em>est bien défini même si son ordre est incohérent avec les égaux ; il ne parvient pas à respecter le contrat général de l’interface Map .

Toutes les classes d’implémentation de carte triées à usage général doivent fournir quatre constructeurs « standard ». Il n’est pas possible d’appliquer cette recommandation si les constructeurs requis ne peuvent pas être spécifiés par les interfaces. Les constructeurs « standard » attendus pour toutes les implémentations de carte triées sont : <le constructeur ol><li>A void (aucun argument), qui crée une carte triée vide triée en fonction de l’ordre naturel de ses clés.</li li>><Un constructeur avec un seul argument de typeComparator, qui crée une carte triée vide triée en fonction du comparateur spécifié.</li li>><Un constructeur avec un seul argument de typeMap, qui crée une nouvelle carte avec les mêmes mappages clé-valeur que son argument, trié en fonction de l’ordre naturel des clés.</li><li>Un constructeur avec un seul argument de typeSortedMap, qui crée une carte triée avec les mêmes mappages clé-valeur et le même ordre que la carte triée d’entrée.</li></ol>

<forte>note</forte> : plusieurs méthodes retournent des sous-mappages avec des plages de clés restreintes. Ces plages sont <mi-ouvertes></em, c’est-à-dire> qu’elles incluent leur point de terminaison faible, mais pas leur point de terminaison élevé (le cas échéant). Si vous avez besoin d’une <plage fermée em>> (qui inclut les deux points de terminaison), et que le type de clé autorise le calcul du successeur d’une clé donnée, demandez simplement la sous-plage à partir successor(highEndpoint)de lowEndpoint .< Par exemple, supposons qu’il m s’agit d’une carte dont les clés sont des chaînes. L’idiome suivant obtient une vue contenant tous les mappages clé-valeur dans m lesquels les clés sont comprises low et highinclusives :

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

Une technique similaire peut être utilisée pour générer une <plage ouverte em>(qui contient ni point de terminaison). L’idiome suivant obtient une vue contenant tous les mappages clé-valeur dans m lesquels les clés sont comprises low et highexclusives :

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

Cette interface est membre de l’infrastructure Java Collections.

Ajouté dans la version 1.2.

Java documentation pour java.util.SortedMap.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Propriétés

Nom	Description
Handle	Obtient la valeur JNI de l’objet Android sous-jacent. (Hérité de IJavaObject)
IsEmpty	Retourne si cette carte est vide. (Hérité de IMap)
JniIdentityHashCode	Retourne la valeur de `java.lang.System.identityHashCode()` l’instance encapsulée. (Hérité de IJavaPeerable)
JniManagedPeerState	État de l’homologue managé. (Hérité de IJavaPeerable)
JniObjectReferenceControlBlock	Qui `Map` fournit également un <ordre> total em</em> sur ses clés. (Hérité de IJavaPeerable)
JniPeerMembers	Prise en charge de l’accès aux membres et de l’appel. (Hérité de IJavaPeerable)
PeerReference	Retourne une JniObjectReference instance d’objet Java encapsulée. (Hérité de IJavaPeerable)

Méthodes

Nom	Description
Clear()	Supprime tous les mappages de ce mappage (opération facultative). (Hérité de IMap)
Comparator()	Retourne le comparateur utilisé pour classer les clés dans cette carte, ou `null` si cette carte utilise l’ordre naturel comparable de ses clés.
Compute(Object, IBiFunction)	Tente de calculer un mappage pour la clé spécifiée et sa valeur mappée actuelle (ou `null` s’il n’existe aucun mappage actuel). (Hérité de IMap)
ComputeIfAbsent(Object, IFunction)	Si la clé spécifiée n’est pas déjà associée à une valeur (ou à `null`laquelle elle est mappée), tente de calculer sa valeur à l’aide de la fonction de mappage donnée et l’entre dans cette carte, sauf si `null`. (Hérité de IMap)
ComputeIfPresent(Object, IBiFunction)	Si la valeur de la clé spécifiée est présente et non null, tente de calculer un nouveau mappage en fonction de la clé et de sa valeur mappée actuelle. (Hérité de IMap)
ContainsKey(Object)	Retourne `true` si cette carte contient un mappage pour la clé spécifiée. (Hérité de IMap)
ContainsValue(Object)	Retourne `true` si cette carte mappe une ou plusieurs clés à la valeur spécifiée. (Hérité de IMap)
Disposed()	Appelé lorsque l’instance a été supprimée. (Hérité de IJavaPeerable)
DisposeUnlessReferenced()	S’il n’existe aucune référence en suspens à cette instance, les appels `Dispose()`; sinon, ne fait rien. (Hérité de IJavaPeerable)
EntrySet()	Retourne une `Set` vue des mappages contenus dans cette carte.
Equals(Object)	Compare l’objet spécifié à cette carte pour l’égalité. (Hérité de IMap)
Finalized()	Appelé lorsque l’instance a été finalisée. (Hérité de IJavaPeerable)
FirstEntry()	Qui `Map` fournit également un <ordre> total em</em> sur ses clés. (Hérité de ISequencedMap)
FirstKey()	Retourne la première clé (la plus basse) actuellement dans cette carte.
ForEach(IBiConsumer)	Effectue l’action donnée pour chaque entrée de ce mappage jusqu’à ce que toutes les entrées aient été traitées ou que l’action lève une exception. (Hérité de IMap)
Get(Object)	Retourne la valeur à laquelle la clé spécifiée est mappée, ou `null` si cette carte ne contient aucun mappage pour la clé. (Hérité de IMap)
GetHashCode()	Retourne la valeur du code de hachage pour cette carte. (Hérité de IMap)
GetOrDefault(Object, Object)	Retourne la valeur à laquelle la clé spécifiée est mappée, ou `defaultValue` si cette carte ne contient aucun mappage pour la clé. (Hérité de IMap)
HeadMap(Object)	Retourne une vue de la partie de cette carte dont les clés sont strictement inférieures `toKey`à .
KeySet()	Retourne une `Set` vue des clés contenues dans cette carte.
LastEntry()	Qui `Map` fournit également un <ordre> total em</em> sur ses clés. (Hérité de ISequencedMap)
LastKey()	Retourne la dernière clé (la plus élevée) actuellement dans cette carte.
Merge(Object, Object, IBiFunction)	Si la clé spécifiée n’est pas déjà associée à une valeur ou est associée à null, l’associe à la valeur non null donnée. (Hérité de IMap)
PollFirstEntry()	Qui `Map` fournit également un <ordre> total em</em> sur ses clés. (Hérité de ISequencedMap)
PollLastEntry()	Qui `Map` fournit également un <ordre> total em</em> sur ses clés. (Hérité de ISequencedMap)
Put(Object, Object)	Associe la valeur spécifiée à la clé spécifiée dans cette carte (opération facultative). (Hérité de IMap)
PutAll(IDictionary)	Copie tous les mappages de la carte spécifiée dans cette carte (opération facultative). (Hérité de IMap)
PutFirst(Object, Object)	Insère le mappage donné dans la carte s’il n’est pas déjà présent ou remplace la valeur d’un mappage s’il est déjà présent (opération facultative). (Hérité de ISequencedMap)
PutIfAbsent(Object, Object)	Si la clé spécifiée n’est pas déjà associée à une valeur (ou est mappée à ) l’associe à `null`la valeur donnée et retourne `null`, sinon retourne la valeur actuelle. (Hérité de IMap)
PutLast(Object, Object)	Insère le mappage donné dans la carte s’il n’est pas déjà présent ou remplace la valeur d’un mappage s’il est déjà présent (opération facultative). (Hérité de ISequencedMap)
Remove(Object, Object)	Supprime l’entrée de la clé spécifiée uniquement si elle est actuellement mappée à la valeur spécifiée. (Hérité de IMap)
Remove(Object)	Supprime le mappage d’une clé de ce mappage s’il est présent (opération facultative). (Hérité de IMap)
Replace(Object, Object, Object)	Remplace l’entrée de la clé spécifiée uniquement si elle est actuellement mappée à la valeur spécifiée. (Hérité de IMap)
Replace(Object, Object)	Remplace l’entrée de la clé spécifiée uniquement si elle est actuellement mappée à une valeur. (Hérité de IMap)
ReplaceAll(IBiFunction)	Remplace la valeur de chaque entrée par le résultat de l’appel de la fonction donnée sur cette entrée jusqu’à ce que toutes les entrées aient été traitées ou que la fonction lève une exception. (Hérité de IMap)
Reversed()	Retourne une vue inversée de cette carte. (Hérité de ISequencedMap)
SequencedEntrySet()	Retourne une `SequencedSet` vue de cette carte `#entrySet entrySet`. (Hérité de ISequencedMap)
SequencedKeySet()	Retourne une `SequencedSet` vue de cette carte `#keySet keySet`. (Hérité de ISequencedMap)
SequencedValues()	Retourne une `SequencedCollection` vue de la collection de `#values values` cette carte. (Hérité de ISequencedMap)
SetJniIdentityHashCode(Int32)	Définissez la valeur retournée par `JniIdentityHashCode`. (Hérité de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Qui `Map` fournit également un <ordre> total em</em> sur ses clés. (Hérité de IJavaPeerable)
SetPeerReference(JniObjectReference)	Définissez la valeur retournée par `PeerReference`. (Hérité de IJavaPeerable)
Size()	Retourne le nombre de mappages clé-valeur dans ce mappage. (Hérité de IMap)
SubMap(Object, Object)	Retourne une vue de la partie de cette carte dont les clés vont de `fromKey`, inclusive, à `toKey`, exclusives.
TailMap(Object)	Retourne une vue de la partie de cette carte dont les clés sont supérieures ou égales à `fromKey`.
UnregisterFromRuntime()	Annulez l’inscription de cette instance afin que le runtime ne le retourne pas à partir d’appels futurs Java.Interop.JniRuntime+JniValueManager.PeekValue . (Hérité de IJavaPeerable)
Values()	Retourne une `Collection` vue des valeurs contenues dans cette carte.

Implémentations d’interfaces explicites

Nom	Description
ISequencedMap.PutFirst(Object, Object)	Lève `UnsupportedOperationException`.
ISequencedMap.PutLast(Object, Object)	Lève `UnsupportedOperationException`.
ISequencedMap.Reversed()	Qui `Map` fournit également un <ordre> total em</em> sur ses clés.

Méthodes d’extension

Nom	Description
GetJniTypeName(IJavaPeerable)	Obtient le nom JNI du type de l’instance `self`.
JavaAs<TResult>(IJavaPeerable)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.
JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Qui `Map` fournit également un <ordre> total em</em> sur ses clés.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.

S’applique à