INavigableMap Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Расширенный SortedMap
с методами навигации, возвращающими ближайшие совпадения для заданных целевых объектов поиска.
[Android.Runtime.Register("java/util/NavigableMap", "", "Java.Util.INavigableMapInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public interface INavigableMap : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ISortedMap
[<Android.Runtime.Register("java/util/NavigableMap", "", "Java.Util.INavigableMapInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type INavigableMap = interface
interface ISortedMap
interface IMap
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Производный
- Атрибуты
- Реализации
Комментарии
Расширенный SortedMap
с методами навигации, возвращающими ближайшие совпадения для заданных целевых объектов поиска. Методы #lowerEntry
, #floorEntry
, #ceilingEntry
, и #higherEntry
возвращают Map.Entry
объекты, связанные с ключами соответственно меньше, меньше или равно, больше или равно и больше заданного ключа, возвращая null
, если такого ключа нет. Аналогичным образом методы #lowerKey
, #floorKey
, #ceilingKey
и #higherKey
возвращают только связанные ключи. Все эти методы предназначены для поиска, а не для обхода записей.
Доступ к объекту NavigableMap
и обход может осуществляться в порядке ключа по возрастанию или по убыванию. Метод #descendingMap
возвращает представление карты с инвертироваными чувствами всех реляционных и направленных методов. Производительность операций и представлений по возрастанию, скорее всего, будет выше, чем у убывающих. Методы #subMap(Object, boolean, Object, boolean) subMap(K, boolean, K, boolean)
, #headMap(Object, boolean) headMap(K, boolean)
и #tailMap(Object, boolean) tailMap(K, boolean)
отличаются от методов с подобными именами SortedMap
тем, что они принимают дополнительные аргументы, описывающие, являются ли нижние и верхние границы инклюзивными или эксклюзивными. Вложенные карты любого NavigableMap
объекта должны реализовывать NavigableMap
интерфейс .
Этот интерфейс дополнительно определяет методы #firstEntry
, #pollFirstEntry
, #lastEntry
и #pollLastEntry
, которые возвращают и (или) удаляют наименьшее и наибольшее сопоставления, если таковые существуют, в противном случае возвращая null
.
Реализация методов, возвращающих ввод, должна возвращать Map.Entry
пары, представляющие моментальные снимки сопоставлений на момент их создания, и поэтому обычно <>не<> поддерживают необязательный Entry.setValue
метод. Однако обратите внимание, что сопоставления в связанной карте можно изменить с помощью метода put
.
Методы , и указываются для возвратаSortedMap
, чтобы разрешить существующую реализацию SortedMap
для реализации NavigableMap
, но расширения и реализации этого интерфейса рекомендуется переопределить эти методы для возврата NavigableMap
.#tailMap(Object) tailMap(K)
#headMap(Object) headMap(K)
#subMap(Object, Object) subMap(K, K)
Аналогичным #keySet()
образом можно переопределить для возврата NavigableSet
.
Добавлено в версии 1.6.
Документация по Java для java.util.NavigableMap
.
Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом Android и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License.
Свойства
Handle |
Возвращает значение JNI базового объекта Android. (Унаследовано от IJavaObject) |
IsEmpty |
Возвращает значение, указывающее, является ли эта карта пустой. (Унаследовано от IMap) |
JniIdentityHashCode |
Возвращает значение |
JniManagedPeerState |
Состояние управляемого однорангового узла. (Унаследовано от IJavaPeerable) |
JniPeerMembers |
Поддержка доступа к членам и вызова. (Унаследовано от IJavaPeerable) |
PeerReference |
Возвращает экземпляр JniObjectReference объекта Java, заключенный в оболочку. (Унаследовано от IJavaPeerable) |
Методы
CeilingEntry(Object) |
Возвращает сопоставление "ключ-значение", связанное с наименьшим ключом, превышающим или равным заданному ключу, или |
CeilingKey(Object) |
Возвращает наименьший ключ, превышающий или равный заданному ключу, или |
Clear() |
Удаляет все сопоставления из этой карты (необязательная операция). (Унаследовано от IMap) |
Comparator() |
Возвращает компаратор, используемый для упорядочения ключей на этой карте, или |
Compute(Object, IBiFunction) |
Пытается вычислить сопоставление для указанного ключа и его текущего сопоставленного значения (или |
ComputeIfAbsent(Object, IFunction) |
Если указанный ключ еще не связан со значением (или сопоставлен |
ComputeIfPresent(Object, IBiFunction) |
Если значение для указанного ключа присутствует и не равно NULL, пытается вычислить новое сопоставление с учетом ключа и его текущего сопоставленного значения. (Унаследовано от IMap) |
ContainsKey(Object) |
Возвращает значение |
ContainsValue(Object) |
Возвращает значение |
DescendingKeySet() |
Возвращает представление ключей в обратном порядке |
DescendingMap() |
Возвращает представление в обратном порядке сопоставлений, содержащихся в этой карте. |
Disposed() |
Вызывается при удалении экземпляра. (Унаследовано от IJavaPeerable) |
DisposeUnlessReferenced() |
Если отсутствуют невыполненные ссылки на этот экземпляр, вызывает метод |
EntrySet() |
Возвращает |
Equals(Object) |
Сравнивает указанный объект с данной картой на равенство. (Унаследовано от IMap) |
Finalized() |
Вызывается при завершении работы экземпляра. (Унаследовано от IJavaPeerable) |
FirstEntry() |
Возвращает сопоставление "ключ-значение", связанное с наименьшим ключом на этой карте, или |
FirstKey() |
Возвращает первый (самый низкий) ключ на данной карте. (Унаследовано от ISortedMap) |
FloorEntry(Object) |
Возвращает сопоставление "ключ-значение", связанное с наибольшим ключом, меньшим или равным заданному ключу, или |
FloorKey(Object) |
Возвращает наибольшее значение ключа, меньшее или равное заданному ключу, или |
ForEach(IBiConsumer) |
Выполняет заданное действие для каждой записи в этой карте, пока не будут обработаны все записи или действие не вызовет исключение. (Унаследовано от IMap) |
Get(Object) |
Возвращает значение, с которым сопоставляется указанный ключ, или |
GetHashCode() |
Возвращает значение хэш-кода для этой карты. (Унаследовано от IMap) |
GetOrDefault(Object, Object) |
Возвращает значение, с которым сопоставляется указанный ключ, или |
HeadMap(Object) |
Добавляемое |
HeadMap(Object, Boolean) |
Возвращает представление части этой карты, ключи которой меньше (или равны, если |
HigherEntry(Object) |
Возвращает сопоставление "ключ-значение", связанное с наименьшим ключом, строго превышающим заданный ключ, или |
HigherKey(Object) |
Возвращает наименьший ключ, строго превышающий заданный ключ, или |
KeySet() |
|
LastEntry() |
Возвращает сопоставление "ключ-значение", связанное с наибольшим ключом на этой карте, или |
LastKey() |
Возвращает последний (самый высокий) ключ на данной карте. (Унаследовано от ISortedMap) |
LowerEntry(Object) |
Возвращает сопоставление "ключ-значение", связанное с наибольшим ключом, строго меньшим, чем заданный ключ, или |
LowerKey(Object) |
Возвращает наибольший ключ строго меньше заданного ключа или |
Merge(Object, Object, IBiFunction) |
Если указанный ключ еще не связан со значением или связан с null, связывает его с заданным ненулевым значением. (Унаследовано от IMap) |
NavigableKeySet() |
|
PollFirstEntry() |
Удаляет и возвращает сопоставление "ключ—значение", связанное с наименьшим ключом в этой карте, или |
PollLastEntry() |
Удаляет и возвращает сопоставление "ключ-значение", связанное с наибольшим ключом на этой карте, или |
Put(Object, Object) |
Связывает указанное значение с указанным ключом в этой карте (необязательная операция). (Унаследовано от IMap) |
PutAll(IDictionary) |
Копирует все сопоставления из указанной карты в эту карту (необязательная операция). (Унаследовано от IMap) |
PutIfAbsent(Object, Object) |
Если указанный ключ еще не связан со значением (или сопоставлен с |
Remove(Object) |
Удаляет сопоставление ключа с этой карты, если оно присутствует (необязательная операция). (Унаследовано от IMap) |
Remove(Object, Object) |
Удаляет запись для указанного ключа, только если она в настоящее время сопоставлена с указанным значением. (Унаследовано от IMap) |
Replace(Object, Object) |
Заменяет запись для указанного ключа только в том случае, если она сопоставлена с каким-то значением. (Унаследовано от IMap) |
Replace(Object, Object, Object) |
Заменяет запись для указанного ключа только в том случае, если она сопоставлена с указанным значением. (Унаследовано от IMap) |
ReplaceAll(IBiFunction) |
Заменяет значение каждой записи результатом вызова данной функции для этой записи до тех пор, пока не будут обработаны все записи или функция не создаст исключение. (Унаследовано от IMap) |
SetJniIdentityHashCode(Int32) |
Задайте значение, возвращаемое . |
SetJniManagedPeerState(JniManagedPeerStates) |
Расширенный |
SetPeerReference(JniObjectReference) |
Задайте значение, возвращаемое . |
Size() |
Возвращает количество сопоставлений "ключ-значение" на этой карте. (Унаследовано от IMap) |
SubMap(Object, Boolean, Object, Boolean) |
Возвращает представление части этой карты, ключи которой варьируются от |
SubMap(Object, Object) |
Добавляемое |
TailMap(Object) |
Добавляемое |
TailMap(Object, Boolean) |
Возвращает представление части этой карты, ключи которой больше (или равны, если |
UnregisterFromRuntime() |
Отмените регистрацию этого экземпляра, чтобы среда выполнения не возвращала его из будущих Java.Interop.JniRuntime+JniValueManager.PeekValue вызовов. (Унаследовано от IJavaPeerable) |
Values() |
|
Методы расширения
JavaCast<TResult>(IJavaObject) |
Выполняет преобразование типа, проверенного средой выполнения Android. |
JavaCast<TResult>(IJavaObject) |
Расширенный |
GetJniTypeName(IJavaPeerable) |
Расширенный |