Spec-Zone .ru
спецификации, руководства, описания, API
|
K
- тип ключей сохраняется этой картойV
- тип отображенных значенийpublic interface NavigableMap<K,V> extends SortedMap<K,V>
SortedMap
расширенный с помощью методов навигации, возвращая самые близкие соответствия для данных целей поиска. Методы lowerEntry
, floorEntry
, ceilingEntry
, и higherEntry
возвратиться Map.Entry
объекты, связанные с ключами соответственно меньше чем, меньше чем или равный, больше чем или равный, и больше чем данный ключ, возвращаясь null
если нет такого ключа. Точно так же методы lowerKey
, floorKey
, ceilingKey
, и higherKey
возвратите только связанные ключи. Все эти методы разрабатываются для того, чтобы расположиться, не пересекая записи. A NavigableMap
может быть получен доступ и пересечен или в возрастании или в убывающем ключевом порядке. descendingMap
метод возвращает представление карты со смыслами всех реляционных и направленных инвертированных методов. Производительность возрастающих операций и представлений, вероятно, будет быстрее чем тот из убывающих. Методы subMap
, headMap
, и tailMap
отличайтесь от подобно-именованного SortedMap
методы в принятии дополнительных параметров, описывающих, являются ли нижние и верхние границы содержащими против монопольного. Подкарты любого NavigableMap
должен реализовать NavigableMap
интерфейс.
Этот интерфейс дополнительно определяет методы firstEntry
, pollFirstEntry
, lastEntry
, и pollLastEntry
тот возврат и/или удаляет наименее и самые большие отображения, если кто-либо существует, еще возвращаясь null
.
Реализации возвращающих запись методов, как ожидают, возвратятся Map.Entry
пары, представляющие снимки отображений в то время, когда они были произведены, и таким образом обычно не поддерживают дополнительное Entry.setValue
метод. Отметьте однако, что возможно изменить отображения в связанном методе использования карты put
.
Методы subMap(K, K)
, headMap(K)
, и tailMap(K)
определяются, чтобы возвратиться SortedMap
позволить существующие реализации SortedMap
быть совместимо retrofitted, чтобы реализовать NavigableMap
, но расширения и реализации этого интерфейса поощряются переопределить эти методы, чтобы возвратиться NavigableMap
. Точно так же SortedMap.keySet()
может быть overriden, чтобы возвратиться NavigableSet
.
Этот интерфейс является элементом Платформы Наборов Java.
Модификатор и Тип | Метод и Описание |
---|---|
Map.Entry<K,V> |
ceilingEntry(K key)
Возвращает отображение значения ключа, связанное с наименее ключевым большим чем или равный данному ключу, или
null если нет такого ключа. |
K |
ceilingKey(K key)
Возвращает наименее ключевое большее чем или равный данному ключу, или
null если нет такого ключа. |
NavigableSet<K> |
descendingKeySet()
Возвращает обратный порядок
NavigableSet представление ключей содержится в этой карте. |
NavigableMap<K,V> |
descendingMap()
Возвращает представление обратного порядка отображений, содержавшихся в этой карте.
|
Map.Entry<K,V> |
firstEntry()
Возвращает отображение значения ключа, связанное с наименьшим количеством ключа в этой карте, или
null если карта пуста. |
Map.Entry<K,V> |
floorEntry(K key)
Возвращает отображение значения ключа, связанное с самым большим ключом, меньше чем или равным данному ключу, или
null если нет такого ключа. |
K |
floorKey(K key)
Возвращает самый большой ключ, меньше чем или равный данному ключу, или
null если нет такого ключа. |
SortedMap<K,V> |
headMap(K toKey)
Возвращает представление части этой карты, ключи которой являются строго меньше чем
toKey . |
NavigableMap<K,V> |
headMap(K toKey, boolean inclusive)
Возвращает представление части этой карты, ключи которой являются меньше чем (или равный, если
inclusive истина), toKey . |
Map.Entry<K,V> |
higherEntry(K key)
Возвращает отображение значения ключа, связанное с наименее ключевым, строго больше чем данный ключ, или
null если нет такого ключа. |
K |
higherKey(K key)
Возвращает наименее ключевое, строго больше чем данный ключ, или
null если нет такого ключа. |
Map.Entry<K,V> |
lastEntry()
Возвращает отображение значения ключа, связанное с самым большим ключом в этой карте, или
null если карта пуста. |
Map.Entry<K,V> |
lowerEntry(K key)
Возвращает отображение значения ключа, связанное с самым большим ключом строго меньше чем данный ключ, или
null если нет такого ключа. |
K |
lowerKey(K key)
Возвращает самый большой ключ строго меньше чем данный ключ, или
null если нет такого ключа. |
NavigableSet<K> |
navigableKeySet()
Возвраты a
NavigableSet представление ключей содержится в этой карте. |
Map.Entry<K,V> |
pollFirstEntry()
Удаляет и возвращает отображение значения ключа, связанное с наименьшим количеством ключа в этой карте, или
null если карта пуста. |
Map.Entry<K,V> |
pollLastEntry()
Удаляет и возвращает отображение значения ключа, связанное с самым большим ключом в этой карте, или
null если карта пуста. |
NavigableMap<K,V> |
subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive)
Возвращает представление части этой карты, ключи которой располагаются от
fromKey к toKey . |
SortedMap<K,V> |
subMap(K fromKey, K toKey)
Возвращает представление части этой карты, ключи которой располагаются от
fromKey , включительно, к toKey , монопольный. |
SortedMap<K,V> |
tailMap(K fromKey)
Возвращает представление части этой карты, ключи которой больше чем или равны
fromKey . |
NavigableMap<K,V> |
tailMap(K fromKey, boolean inclusive)
Возвращает представление части этой карты, ключи которой больше чем (или равны, если
inclusive истина), fromKey . |
comparator, entrySet, firstKey, keySet, lastKey, values
clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, equals, forEach, get, getOrDefault, hashCode, isEmpty, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size
Map.Entry<K,V> lowerEntry(K key)
null
если нет такого ключа.key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта не разрешает нулевые ключиK lowerKey(K key)
null
если нет такого ключа.key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта не разрешает нулевые ключиMap.Entry<K,V> floorEntry(K key)
null
если нет такого ключа.key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта не разрешает нулевые ключиK floorKey(K key)
null
если нет такого ключа.key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта не разрешает нулевые ключиMap.Entry<K,V> ceilingEntry(K key)
null
если нет такого ключа.key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта не разрешает нулевые ключиK ceilingKey(K key)
null
если нет такого ключа.key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта не разрешает нулевые ключиMap.Entry<K,V> higherEntry(K key)
null
если нет такого ключа.key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта не разрешает нулевые ключиK higherKey(K key)
null
если нет такого ключа.key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта не разрешает нулевые ключиMap.Entry<K,V> firstEntry()
null
если карта пуста.null
если эта карта пустаMap.Entry<K,V> lastEntry()
null
если карта пуста.null
если эта карта пустаMap.Entry<K,V> pollFirstEntry()
null
если карта пуста.null
если эта карта пустаMap.Entry<K,V> pollLastEntry()
null
если карта пуста.null
если эта карта пустаNavigableMap<K,V> descendingMap()
remove
работа), результаты итерации неопределены. У возвращенной карты есть упорядочивание, эквивалентное Collections.reverseOrder
(comparator()). Выражение m.descendingMap().descendingMap()
возвращает представление m
чрезвычайно эквивалентный m
.
NavigableSet<K> navigableKeySet()
NavigableSet
представление ключей содержится в этой карте. iterator набора возвращает ключи в порядке по возрастанию. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме через собственный iterator's remove
работа), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove
, Set.remove
, removeAll
, retainAll
, и clear
операции. Это не поддерживает add
или addAll
операции.NavigableSet<K> descendingKeySet()
NavigableSet
представление ключей содержится в этой карте. iterator набора возвращает ключи в порядке по убыванию. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме через собственный iterator's remove
работа), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove
, Set.remove
, removeAll
, retainAll
, и clear
операции. Это не поддерживает add
или addAll
операции.NavigableMap<K,V> subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive)
fromKey
к toKey
. Если fromKey
и toKey
равны, возвращенная карта не пуста если fromInclusive
и toInclusive
оба истина. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException
на попытке вставить ключ за пределами его диапазона, или создать подкарту, любая из чей конечных точек лежат вне его диапазона.
fromKey
- низкая конечная точка ключей в возвращенной картеfromInclusive
- true
если низкая конечная точка должна быть включена в возвращенное представлениеtoKey
- высокая конечная точка ключей в возвращенной картеtoInclusive
- true
если высокая конечная точка должна быть включена в возвращенное представлениеfromKey
к toKey
ClassCastException
- если fromKey
и toKey
не может быть по сравнению с друг другом, используя компаратор этой карты (или, если у карты нет никакого компаратора, используя естественное упорядочивание). Реализации, но не обязаны, может выдать это исключение если fromKey
или toKey
не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException
- если fromKey
или toKey
нуль, и эта карта не разрешает нулевые ключиIllegalArgumentException
- если fromKey
больше чем toKey
; или если у этой самой карты есть ограниченный диапазон, и fromKey
или toKey
находится вне границ диапазонаNavigableMap<K,V> headMap(K toKey, boolean inclusive)
inclusive
истина), toKey
. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException
на попытке вставить ключевую внешнюю сторону ее диапазон.
toKey
- высокая конечная точка ключей в возвращенной картеinclusive
- true
если высокая конечная точка должна быть включена в возвращенное представлениеinclusive
истина), toKey
ClassCastException
- если toKey
не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если toKey
не реализует Comparable
). Реализации, но не обязаны, может выдать это исключение если toKey
не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException
- если toKey
нуль, и эта карта не разрешает нулевые ключиIllegalArgumentException
- если у этой самой карты есть ограниченный диапазон, и toKey
находится вне границ диапазонаNavigableMap<K,V> tailMap(K fromKey, boolean inclusive)
inclusive
истина), fromKey
. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException
на попытке вставить ключевую внешнюю сторону ее диапазон.
fromKey
- низкая конечная точка ключей в возвращенной картеinclusive
- true
если низкая конечная точка должна быть включена в возвращенное представлениеinclusive
истина), fromKey
ClassCastException
- если fromKey
не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если fromKey
не реализует Comparable
). Реализации, но не обязаны, может выдать это исключение если fromKey
не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException
- если fromKey
нуль, и эта карта не разрешает нулевые ключиIllegalArgumentException
- если у этой самой карты есть ограниченный диапазон, и fromKey
находится вне границ диапазонаSortedMap<K,V> subMap(K fromKey, K toKey)
fromKey
, включительно, к toKey
, монопольный. (Если fromKey
и toKey
равны, возвращенная карта пуста.) Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException
на попытке вставить ключевую внешнюю сторону ее диапазон.
Эквивалентный subMap(fromKey, true, toKey, false)
.
subMap
в интерфейсе SortedMap<K,V>
fromKey
- низкая конечная точка (включительно) ключей в возвращенной картеtoKey
- высокая конечная точка (монопольная) из ключей в возвращенной картеfromKey
, включительно, к toKey
, монопольныйClassCastException
- если fromKey
и toKey
не может быть по сравнению с друг другом, используя компаратор этой карты (или, если у карты нет никакого компаратора, используя естественное упорядочивание). Реализации, но не обязаны, может выдать это исключение если fromKey
или toKey
не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException
- если fromKey
или toKey
нуль, и эта карта не разрешает нулевые ключиIllegalArgumentException
- если fromKey
больше чем toKey
; или если у этой самой карты есть ограниченный диапазон, и fromKey
или toKey
находится вне границ диапазонаSortedMap<K,V> headMap(K toKey)
toKey
. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException
на попытке вставить ключевую внешнюю сторону ее диапазон.
Эквивалентный headMap(toKey, false)
.
headMap
в интерфейсе SortedMap<K,V>
toKey
- высокая конечная точка (монопольная) из ключей в возвращенной картеtoKey
ClassCastException
- если toKey
не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если toKey
не реализует Comparable
). Реализации, но не обязаны, может выдать это исключение если toKey
не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException
- если toKey
нуль, и эта карта не разрешает нулевые ключиIllegalArgumentException
- если у этой самой карты есть ограниченный диапазон, и toKey
находится вне границ диапазонаSortedMap<K,V> tailMap(K fromKey)
fromKey
. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException
на попытке вставить ключевую внешнюю сторону ее диапазон.
Эквивалентный tailMap(fromKey, true)
.
tailMap
в интерфейсе SortedMap<K,V>
fromKey
- низкая конечная точка (включительно) ключей в возвращенной картеfromKey
ClassCastException
- если fromKey
не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если fromKey
не реализует Comparable
). Реализации, но не обязаны, может выдать это исключение если fromKey
не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException
- если fromKey
нуль, и эта карта не разрешает нулевые ключиIllegalArgumentException
- если у этой самой карты есть ограниченный диапазон, и fromKey
находится вне границ диапазона
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92