ISortedMap Интерфейс

Определение

Пространство имен:: Java.Util

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Это Map также обеспечивает <>общее упорядочение< или эм> на его ключах.

[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.IMap

[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

[<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

Производный: Java.Util.INavigableMap

Java.Util.TreeMap

Атрибуты: RegisterAttribute JavaTypeParametersAttribute

Реализации: IJavaObject IJavaPeerable IMap IDisposable ISequencedMap

Это Map также обеспечивает <>общее упорядочение< или эм> на его ключах. Карта упорядочена в соответствии с аналогичным естественным упорядочением ключей или Comparator обычно предоставляется при отсортированном времени создания карты. Этот порядок отражается при итерации представлений коллекции отсортированных карт (возвращаемых методами entrySetkeySet и values методами). Для использования упорядочения предоставляются несколько дополнительных операций. (Этот интерфейс является аналогом SortedSetкарты .)

Все ключи, вставляемые в отсортированную карту, должны реализовывать Comparable интерфейс (или приниматься указанным компратором). Кроме того, все такие ключи должны быть>< взаимно сопоставимыми: k1.compareTo(k2) (илиcomparator.compare(k1, k2)) не должны вызывать ClassCastException ключи k1 и k2 в отсортированных картах. Попытки нарушить это ограничение приведет к ClassCastExceptionвозникновению вызова метода или конструктора.

Обратите внимание, что порядок, поддерживаемый отсортированной картой (независимо от того, предоставляется ли явный компратор) должен быть <>согласован с равными< или em>, если отсортированная карта должна правильно реализовать Map интерфейс. (См. Comparable интерфейс или Comparator интерфейс для точного определения em>, согласованного <с equals.) Это так, потому что Map интерфейс определен с точки зрения equals операции, но отсортированная карта выполняет все сравнения ключей с помощью его compareTo метода (илиcompare), поэтому два ключа, которые считаются равными этим методом, с точки зрения отсортированных карт, равны. Поведение схемы <>дерева em хорошо определено, даже если его упорядочение не соответствует равным, он просто не соответствует общему контракту Map интерфейса.

Все классы реализации схемы с сортировкой общего назначения должны предоставлять четыре "стандартных" конструктора. Невозможно применить эту рекомендацию, хотя необходимые конструкторы не могут быть указаны интерфейсами. Ожидаемые конструкторы "стандартный" для всех отсортированных реализаций карты: <конструктор ol><li>A void (без аргументов), который создает пустую отсортированную карту, отсортированную по естественному упорядочению ключей.<Конструктор /li>><A с одним аргументом типаComparator, который создает пустую отсортированную карту, отсортированную по указанному компаратору.<Конструктор /li>><A с одним аргументом типаMap, который создает новую карту с теми же сопоставлениями ключей и значениями, что и его аргумент, отсортированный по естественному упорядочению ключей.<Конструктор /li>><A с одним аргументом типаSortedMap, который создает новую отсортированную карту с одинаковыми сопоставлениями значений ключей и таким же порядком, что и входная отсортированная карта.</li></ol>

Note: несколько методов возвращают вложенные карты с ограниченными диапазонами ключей. Такие диапазоны являются <>em half-open, то есть они включают их низкую конечную точку, но не их высокую конечную точку (где применимо). Если вам нужен закрытый <>диапазон< или em> (который включает обе конечные точки), а тип ключа позволяет вычислению преемника заданного ключа, просто запрашивать подранг отlowEndpoint.successor(highEndpoint) Например, предположим, что m это карта, ключи которой являются строками. Следующая идиома получает представление, содержащее все сопоставления "ключ-значение", ключи которых находятся между mlow и highвключительно:

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

Аналогичный метод можно использовать для создания открытого <>диапазона< или em> (который не содержит ни конечную точку). Следующий идиом получает представление, содержащее все сопоставления "ключ-значение", ключи которых находятся между mlow и highмонопольными:

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

Этот интерфейс является членом платформы коллекций Java.

Добавлено в версии 1.2.

Java документации по java.util.SortedMap.

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Свойства

Имя	Описание
Handle	Возвращает значение JNI базового объекта Android. (Унаследовано от IJavaObject)
IsEmpty	Возвращает значение, является ли эта карта пустой. (Унаследовано от IMap)
JniIdentityHashCode	Возвращает значение `java.lang.System.identityHashCode()` для упаковаемого экземпляра. (Унаследовано от IJavaPeerable)
JniManagedPeerState	Состояние управляемого однорангового узла. (Унаследовано от IJavaPeerable)
JniPeerMembers	Поддержка доступа к членам и вызовов. (Унаследовано от IJavaPeerable)
PeerReference	JniObjectReference Возвращает экземпляр объекта в оболочке Java. (Унаследовано от IJavaPeerable)

Методы

Имя	Описание
Clear()	Удаляет все сопоставления из этой карты (необязательной операции). (Унаследовано от IMap)
Comparator()	Возвращает компратор, используемый для упорядочивания ключей в этой карте, или `null` если эта карта использует сравнимое естественное упорядочение ключей.
Compute(Object, IBiFunction)	Пытается вычислить сопоставление для указанного ключа и его текущего сопоставленного значения (или `null` если текущее сопоставление отсутствует). (Унаследовано от IMap)
ComputeIfAbsent(Object, IFunction)	Если указанный ключ еще не связан со значением (или сопоставляется с `null`), пытается вычислить его значение с помощью данной функции сопоставления и ввести его в эту карту, если `null`только не будет. (Унаследовано от IMap)
ComputeIfPresent(Object, IBiFunction)	Если значение указанного ключа присутствует и не имеет значения NULL, пытается вычислить новое сопоставление с заданным ключом и его текущим сопоставленным значением. (Унаследовано от IMap)
ContainsKey(Object)	Возвращает, `true` если эта карта содержит сопоставление для указанного ключа. (Унаследовано от IMap)
ContainsValue(Object)	Возвращает, сопоставляется `true` ли эта карта одним или несколькими ключами с указанным значением. (Унаследовано от IMap)
Disposed()	Вызывается при удалении экземпляра. (Унаследовано от IJavaPeerable)
DisposeUnlessReferenced()	Если нет невыполненных ссылок на этот экземпляр, то вызывается `Dispose()`; в противном случае ничего не делает. (Унаследовано от IJavaPeerable)
EntrySet()	`Set` Возвращает представление сопоставлений, содержащихся на этой карте.
Equals(Object)	Сравнивает указанный объект с этой картой для равенства. (Унаследовано от IMap)
Finalized()	Вызывается при завершении экземпляра. (Унаследовано от IJavaPeerable)
FirstEntry()	Это `Map` также обеспечивает <>общее упорядочение< или эм> на его ключах. (Унаследовано от ISequencedMap)
FirstKey()	Возвращает первый (самый низкий) ключ в настоящее время на этой карте.
ForEach(IBiConsumer)	Выполняет заданное действие для каждой записи в этой карте до тех пор, пока все записи не будут обработаны или действие выдает исключение. (Унаследовано от IMap)
Get(Object)	Возвращает значение, с которым сопоставлен указанный ключ, или `null` если эта карта не содержит сопоставления для ключа. (Унаследовано от IMap)
GetHashCode()	Возвращает хэш-значение кода для этой карты. (Унаследовано от IMap)
GetOrDefault(Object, Object)	Возвращает значение, с которым сопоставлен указанный ключ, или `defaultValue` если эта карта не содержит сопоставления для ключа. (Унаследовано от IMap)
HeadMap(Object)	Возвращает представление части этой карты, ключи которых строго меньше `toKey`.
KeySet()	`Set` Возвращает представление ключей, содержащихся на этой карте.
LastEntry()	Это `Map` также обеспечивает <>общее упорядочение< или эм> на его ключах. (Унаследовано от ISequencedMap)
LastKey()	Возвращает последний (самый высокий) ключ в настоящее время на этой карте.
Merge(Object, Object, IBiFunction)	Если указанный ключ еще не связан со значением или связан с значением NULL, связывает его с заданным значением, не имеющим значения NULL. (Унаследовано от IMap)
PollFirstEntry()	Это `Map` также обеспечивает <>общее упорядочение< или эм> на его ключах. (Унаследовано от ISequencedMap)
PollLastEntry()	Это `Map` также обеспечивает <>общее упорядочение< или эм> на его ключах. (Унаследовано от ISequencedMap)
Put(Object, Object)	Связывает указанное значение с указанным ключом в этой карте (необязательной операцией). (Унаследовано от IMap)
PutAll(IDictionary)	Копирует все сопоставления из указанной карты на эту карту (необязательной операции). (Унаследовано от IMap)
PutFirst(Object, Object)	Вставляет заданное сопоставление в карту, если он еще не присутствует или заменяет значение сопоставления, если оно уже присутствует (необязательно). (Унаследовано от ISequencedMap)
PutIfAbsent(Object, Object)	Если указанный ключ еще не связан со значением (или сопоставляется `null`с) связывает его с заданным значением и возвращается, в противном случае возвращает `null`текущее значение. (Унаследовано от IMap)
PutLast(Object, Object)	Вставляет заданное сопоставление в карту, если он еще не присутствует или заменяет значение сопоставления, если оно уже присутствует (необязательно). (Унаследовано от ISequencedMap)
Remove(Object, Object)	Удаляет запись для указанного ключа, только если она сопоставлена с указанным значением. (Унаследовано от IMap)
Remove(Object)	Удаляет сопоставление ключа из этой карты, если оно присутствует (необязательно). (Унаследовано от IMap)
Replace(Object, Object, Object)	Заменяет запись для указанного ключа, только если в данный момент сопоставлено с указанным значением. (Унаследовано от IMap)
Replace(Object, Object)	Заменяет запись для указанного ключа, только если она сопоставлена с некоторым значением. (Унаследовано от IMap)
ReplaceAll(IBiFunction)	Заменяет значение каждой записи результатом вызова данной функции для этой записи до тех пор, пока все записи не будут обработаны или функция выдает исключение. (Унаследовано от IMap)
Reversed()	Возвращает обратное упорядоченное представление этой карты. (Унаследовано от ISequencedMap)
SequencedEntrySet()	`SequencedSet` Возвращает представление этой карты`#entrySet entrySet`. (Унаследовано от ISequencedMap)
SequencedKeySet()	`SequencedSet` Возвращает представление этой карты`#keySet keySet`. (Унаследовано от ISequencedMap)
SequencedValues()	`SequencedCollection` Возвращает представление коллекции этой карты`#values values`. (Унаследовано от ISequencedMap)
SetJniIdentityHashCode(Int32)	Задайте значение, возвращаемое `JniIdentityHashCode`. (Унаследовано от IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Это `Map` также обеспечивает <>общее упорядочение< или эм> на его ключах. (Унаследовано от IJavaPeerable)
SetPeerReference(JniObjectReference)	Задайте значение, возвращаемое `PeerReference`. (Унаследовано от IJavaPeerable)
Size()	Возвращает количество сопоставлений "ключ-значение" в этой карте. (Унаследовано от IMap)
SubMap(Object, Object)	Возвращает представление части этой карты, ключи которого варьируются от `fromKey`, включительно до `toKey`, эксклюзивных.
TailMap(Object)	Возвращает представление части этой карты, ключи которых больше или равны `fromKey`.
UnregisterFromRuntime()	Отмените регистрацию этого экземпляра, чтобы среда выполнения не возвращала ее из будущих Java.Interop.JniRuntime+JniValueManager.PeekValue вызовов. (Унаследовано от IJavaPeerable)
Values()	`Collection` Возвращает представление значений, содержащихся на этой карте.

Явные реализации интерфейса

Имя	Описание
ISequencedMap.PutFirst(Object, Object)	Бросает `UnsupportedOperationException`.
ISequencedMap.PutLast(Object, Object)	Бросает `UnsupportedOperationException`.
ISequencedMap.Reversed()	Это `Map` также обеспечивает <>общее упорядочение< или эм> на его ключах.

Методы расширения

Имя	Описание
GetJniTypeName(IJavaPeerable)	Возвращает имя JNI типа экземпляра `self`.
JavaAs<TResult>(IJavaPeerable)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.
JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Это `Map` также обеспечивает <>общее упорядочение< или эм> на его ключах.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.

Применяется к