NavigableMap (Платформа Java SE 7)

Введите Параметры:
K - тип ключей сохраняется этой картой
V - тип отображенных значений

Все Суперинтерфейсы:

Карта <K, V>, SortedMap <K, V>

Все Известные Подынтерфейсы:

ConcurrentNavigableMap <K, V>

Все Известные Классы с реализацией:

ConcurrentSkipListMap, TreeMap
```
public interface NavigableMap<K,V>
extends SortedMap<K,V>
```
A 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.

С тех пор:

1.6

Вложенная Сводка Класса
- Вложенные классы/интерфейсы, наследованные от интерфейса java.util. Карта
  Map.Entry<K,V>

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`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`.

Методы, наследованные от интерфейса java.util. SortedMap
comparator, entrySet, firstKey, keySet, lastKey, values

Методы, наследованные от интерфейса java.util. Карта
clear, containsKey, containsValue, equals, get, hashCode, isEmpty, put, putAll, remove, size

- Деталь метода
  - lowerEntry
```
Map.Entry<K,V> lowerEntry(K key)
```
    Возвращает отображение значения ключа, связанное с самым большим ключом строго меньше чем данный ключ, или null если нет такого ключа.
    
    Параметры:
    key - ключ
    
    Возвраты:
    запись с самым большим ключом меньше чем key, или null если нет такого ключа
    
    Броски:
    
    ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте
    
    NullPointerException - если указанный ключ является нулем, и эта карта не разрешает нулевые ключи
  - lowerKey
```
K lowerKey(K key)
```
    Возвращает самый большой ключ строго меньше чем данный ключ, или null если нет такого ключа.
    
    Параметры:
    key - ключ
    
    Возвраты:
    самый большой ключ меньше чем key, или null если нет такого ключа
    
    Броски:
    
    ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте
    
    NullPointerException - если указанный ключ является нулем, и эта карта не разрешает нулевые ключи
  - floorEntry
```
Map.Entry<K,V> floorEntry(K key)
```
    Возвращает отображение значения ключа, связанное с самым большим ключом, меньше чем или равным данному ключу, или null если нет такого ключа.
    
    Параметры:
    key - ключ
    
    Возвраты:
    запись с самым большим ключом, меньше чем или равным key, или null если нет такого ключа
    
    Броски:
    
    ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте
    
    NullPointerException - если указанный ключ является нулем, и эта карта не разрешает нулевые ключи
  - floorKey
```
K floorKey(K key)
```
    Возвращает самый большой ключ, меньше чем или равный данному ключу, или null если нет такого ключа.
    
    Параметры:
    key - ключ
    
    Возвраты:
    самый большой ключ, меньше чем или равный key, или null если нет такого ключа
    
    Броски:
    
    ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте
    
    NullPointerException - если указанный ключ является нулем, и эта карта не разрешает нулевые ключи
  - ceilingEntry
```
Map.Entry<K,V> ceilingEntry(K key)
```
    Возвращает отображение значения ключа, связанное с наименее ключевым большим чем или равный данному ключу, или null если нет такого ключа.
    
    Параметры:
    key - ключ
    
    Возвраты:
    запись с наименее ключевым большим чем или равный key, или null если нет такого ключа
    
    Броски:
    
    ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте
    
    NullPointerException - если указанный ключ является нулем, и эта карта не разрешает нулевые ключи
  - ceilingKey
```
K ceilingKey(K key)
```
    Возвращает наименее ключевое большее чем или равный данному ключу, или null если нет такого ключа.
    
    Параметры:
    key - ключ
    
    Возвраты:
    наименее ключевое большее чем или равный key, или null если нет такого ключа
    
    Броски:
    
    ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте
    
    NullPointerException - если указанный ключ является нулем, и эта карта не разрешает нулевые ключи
  - higherEntry
```
Map.Entry<K,V> higherEntry(K key)
```
    Возвращает отображение значения ключа, связанное с наименее ключевым, строго больше чем данный ключ, или null если нет такого ключа.
    
    Параметры:
    key - ключ
    
    Возвраты:
    запись с наименее ключевым большим чем key, или null если нет такого ключа
    
    Броски:
    
    ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте
    
    NullPointerException - если указанный ключ является нулем, и эта карта не разрешает нулевые ключи
  - higherKey
```
K higherKey(K key)
```
    Возвращает наименее ключевое, строго больше чем данный ключ, или null если нет такого ключа.
    
    Параметры:
    key - ключ
    
    Возвраты:
    наименее ключевое большее чем key, или null если нет такого ключа
    
    Броски:
    
    ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте
    
    NullPointerException - если указанный ключ является нулем, и эта карта не разрешает нулевые ключи
  - firstEntry
```
Map.Entry<K,V> firstEntry()
```
    Возвращает отображение значения ключа, связанное с наименьшим количеством ключа в этой карте, или null если карта пуста.
    
    Возвраты:
    запись с наименее ключевым, или null если эта карта пуста
  - lastEntry
```
Map.Entry<K,V> lastEntry()
```
    Возвращает отображение значения ключа, связанное с самым большим ключом в этой карте, или null если карта пуста.
    
    Возвраты:
    запись с самым большим ключом, или null если эта карта пуста
  - pollFirstEntry
```
Map.Entry<K,V> pollFirstEntry()
```
    Удаляет и возвращает отображение значения ключа, связанное с наименьшим количеством ключа в этой карте, или null если карта пуста.
    
    Возвраты:
    удаленная первая запись этой карты, или null если эта карта пуста
  - pollLastEntry
```
Map.Entry<K,V> pollLastEntry()
```
    Удаляет и возвращает отображение значения ключа, связанное с самым большим ключом в этой карте, или null если карта пуста.
    
    Возвраты:
    удаленная последняя запись этой карты, или null если эта карта пуста
  - descendingMap
```
NavigableMap<K,V> descendingMap()
```
    Возвращает представление обратного порядка отображений, содержавшихся в этой карте. Убывающая карта поддерживается этой картой, так изменения к карте отражаются в убывающей карте, и наоборот. Если любая карта изменяется, в то время как итерация по представлению набора любой карты происходит (кроме через собственный iterator's remove работа), результаты итерации неопределены.
    У возвращенной карты есть упорядочивание, эквивалентное Collections.reverseOrder(comparator()). Выражение m.descendingMap().descendingMap() возвращает представление m чрезвычайно эквивалентный m.
    
    Возвраты:
    представление обратного порядка этой карты
  - navigableKeySet
```
NavigableSet<K> navigableKeySet()
```
    Возвраты a NavigableSet представление ключей содержится в этой карте. iterator набора возвращает ключи в порядке по возрастанию. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме через собственный iterator's remove работа), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll, и clear операции. Это не поддерживает add или addAll операции.
    
    Возвраты:
    судоходное представление набора ключей в этой карте
  - descendingKeySet
```
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 находится вне границ диапазона
  - headMap
```
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 находится вне границ диапазона
  - tailMap
```
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 находится вне границ диапазона
  - headMap
```
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 находится вне границ диапазона
  - tailMap
```
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, 2011, Oracle и/или его филиалы. Все права защищены.

Соедините интерфейсом с NavigableMap <K, V>

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от интерфейса java.util. Карта

Сводка метода

Методы, наследованные от интерфейса java.util. SortedMap

Методы, наследованные от интерфейса java.util. Карта

Деталь метода

lowerEntry

lowerKey

floorEntry

floorKey

ceilingEntry

ceilingKey

higherEntry

higherKey

firstEntry

lastEntry

pollFirstEntry

pollLastEntry

descendingMap

navigableKeySet

descendingKeySet

подкарта

headMap

tailMap

подкарта

headMap

tailMap