Spec-Zone .ru
спецификации, руководства, описания, API
|
K
- тип ключей сохраняется этой картойV
- тип отображенных значенийpublic class TreeMap<K,V> extends AbstractMap<K,V> implements NavigableMap<K,V>, Cloneable, Serializable
NavigableMap
реализация. Карта сортируется согласно естественному упорядочиванию ее ключей, или a Comparator
если во время создания карты, в зависимости от которого используется конструктор. Эта реализация обеспечивает гарантируемый журнал (n) стоимость времени для containsKey
, get
, put
и remove
операции. Алгоритмы являются адаптацией тех в Cormen, Леизерсоне, и Введении Ривеста в Алгоритмы.
Отметьте, что упорядочивание, сохраняемое древовидной картой, как любая сортированная карта, и обеспечивается ли явный компаратор, должно быть непротиворечивым с equals
если эта сортированная карта должна правильно реализовать Map
интерфейс. (См. Comparable
или Comparator
для точного определения непротиворечивых с равняется.) Это так потому что Map
интерфейс определяется с точки зрения equals
работа, но сортированная карта выполняет все ключевые сравнения, используя compareTo
(или compare
) метод, таким образом, два ключа, которые считает равными этот метод, с точки зрения сортированной карты, равной. Поведение сортированной карты четко определено, даже если ее упорядочивание непоследовательно с equals
; это только не в состоянии повиноваться общему контракту Map
интерфейс.
Отметьте, что эта реализация не синхронизируется. Если многократные потоки получают доступ к карте одновременно, и по крайней мере один из потоков изменяет карту структурно, это должно синхронизироваться внешне. (Структурная модификация является любой работой, которая добавляет или удаляет одно или более отображений; просто изменение значения, связанного с существующим ключом, не является структурной модификацией.) Это обычно выполняется, синхронизируясь на некотором объекте, который естественно инкапсулирует карту. Если никакой такой объект не существует, карта должна быть "обернута", используя Collections.synchronizedSortedMap
метод. Это лучше всего делается во время создания, чтобы предотвратить случайный несинхронизируемый доступ к карте:
SortedMap m = Collections.synchronizedSortedMap(new TreeMap(...));
iterators, возвращенный iterator
метод наборов, возвращенных всеми "методами представления набора этого class", является сбоем быстро: если карта структурно изменяется когда-либо после того, как iterator создается, всегда кроме через собственный iterator's remove
метод, iterator бросит a ConcurrentModificationException
. Таким образом, перед лицом параллельной модификации, iterator перестал работать быстро и чисто, вместо того, чтобы рискнуть произвольным, недетерминированным поведением в неопределенное время в будущем.
Отметьте, что поведение сбоя быстро iterator не может быть гарантировано, как, вообще говоря, невозможно сделать любые трудные гарантии в присутствии несинхронизируемой параллельной модификации. Приведите бросок iterators к сбою быстро ConcurrentModificationException
на основе максимальных усилий. Поэтому, было бы неправильно записать программу, которая зависела от этого исключения для его правильности: поведение сбоя быстро iterators должно использоваться только, чтобы обнаружить ошибки.
Все Map.Entry
пары, возвращенные методами в этом class и его представлениях, представляют снимки отображений в то время, когда они были произведены. Они не поддерживают Entry.setValue
метод. (Отметьте однако, что возможно изменить отображения в связанном использовании карты put
.)
Этот class является элементом Платформы Наборов Java.
Map
, HashMap
, Hashtable
, Comparable
, Comparator
, Collection
, Сериализированная ФормаAbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>
Конструктор и Описание |
---|
TreeMap()
Создает новую, пустую древовидную карту, используя естественное упорядочивание ее ключей.
|
TreeMap(Comparator<? super K> comparator)
Создает новую, пустую древовидную карту, упорядоченную согласно данному компаратору.
|
TreeMap(Map<? extends K,? extends V> m)
Создает новую древовидную карту, содержащую те же самые отображения как данная карта, упорядоченная согласно естественному упорядочиванию ее ключей.
|
TreeMap(SortedMap<K,? extends V> m)
Создает новую древовидную карту, содержащую те же самые отображения и использующую то же самое упорядочивание в качестве указанной сортированной карты.
|
Модификатор и Тип | Метод и Описание |
---|---|
Map.Entry<K,V> |
ceilingEntry(K key)
Возвращает отображение значения ключа, связанное с наименее ключевым большим чем или равный данному ключу, или
null если нет такого ключа. |
K |
ceilingKey(K key)
Возвращает наименее ключевое большее чем или равный данному ключу, или
null если нет такого ключа. |
void |
clear()
Удаляет все отображения из этой карты.
|
Объект |
clone()
Возвращает мелкую копию этого
TreeMap экземпляр. |
Comparator<? super K> |
comparator()
Возвращает компаратор, используемый, чтобы упорядочить ключи в этой карте, или
null если эта карта использует естественное упорядочивание своих ключей. |
boolean |
containsKey(Object key)
Возвраты
true если эта карта содержит отображение для указанного ключа. |
boolean |
containsValue(Object value)
Возвраты
true если эта карта отображает один или более ключей на указанное значение. |
NavigableSet<K> |
descendingKeySet()
Возвращает обратный порядок
NavigableSet представление ключей содержится в этой карте. |
NavigableMap<K,V> |
descendingMap()
Возвращает представление обратного порядка отображений, содержавшихся в этой карте.
|
Set<Map.Entry<K,V>> |
entrySet()
Возвраты a
Set представление отображений содержится в этой карте. |
Map.Entry<K,V> |
firstEntry()
Возвращает отображение значения ключа, связанное с наименьшим количеством ключа в этой карте, или
null если карта пуста. |
K |
firstKey()
Возвращает первый (самый низкий) ключ в настоящий момент в этой карте.
|
Map.Entry<K,V> |
floorEntry(K key)
Возвращает отображение значения ключа, связанное с самым большим ключом, меньше чем или равным данному ключу, или
null если нет такого ключа. |
K |
floorKey(K key)
Возвращает самый большой ключ, меньше чем или равный данному ключу, или
null если нет такого ключа. |
V |
get(Object 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 если нет такого ключа. |
Set<K> |
keySet()
Возвраты a
Set представление ключей содержится в этой карте. |
Map.Entry<K,V> |
lastEntry()
Возвращает отображение значения ключа, связанное с самым большим ключом в этой карте, или
null если карта пуста. |
K |
lastKey()
Возвращает последний (самый высокий) ключ в настоящий момент в этой карте.
|
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 если карта пуста. |
V |
put(K key, V value)
Связывает указанное значение с указанным ключом в этой карте.
|
void |
putAll(Map<? extends K,? extends V> map)
Копии все отображения от указанной карты до этой карты.
|
V |
remove(Object key)
Удаляет отображение для этого ключа из этого TreeMap если существующий.
|
int |
size()
Возвращает число отображений значения ключа в этой карте.
|
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 . |
Collection<V> |
values()
Возвраты a
Collection представление значений содержится в этой карте. |
equals, hashCode, isEmpty, toString
finalize, getClass, notify, notifyAll, wait, wait, wait
compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, isEmpty, merge, putIfAbsent, remove, replace, replace, replaceAll
public TreeMap()
Comparable
интерфейс. Кроме того все такие ключи должны быть взаимно сопоставимыми: k1.compareTo(k2)
не должен бросить a ClassCastException
для любых ключей k1
и k2
в карте. Если пользователь пытается поместить ключ в карту, которая нарушает это ограничение (например, пользователь пытается поместить строковый ключ в карту, ключи которой являются целыми числами), put(Object key, Object value)
вызов бросит a ClassCastException
.public TreeMap(Comparator<? super K> comparator)
comparator.compare(k1, k2)
не должен бросить a ClassCastException
для любых ключей k1
и k2
в карте. Если пользователь пытается поместить ключ в карту, которая нарушает это ограничение, put(Object key, Object value)
вызов бросит a ClassCastException
.comparator
- компаратор, который будет использоваться, чтобы упорядочить эту карту. Если null
, естественное упорядочивание ключей будет использоваться.public TreeMap(Map<? extends K,? extends V> m)
Comparable
интерфейс. Кроме того все такие ключи должны быть взаимно сопоставимыми: k1.compareTo(k2)
не должен бросить a ClassCastException
для любых ключей k1
и k2
в карте. Этот метод выполняет в n*log (n) время.m
- карта, отображения которой должны быть помещены в эту картуClassCastException
- если ключи в м. не Comparable
, или не взаимно сопоставимыNullPointerException
- если указанная карта является нулемpublic TreeMap(SortedMap<K,? extends V> m)
m
- сортированная карта, отображения которой должны быть помещены в эту карту, и чей компаратор должен использоваться, чтобы сортировать эту картуNullPointerException
- если указанная карта является нулемpublic int size()
public boolean containsKey(Object key)
true
если эта карта содержит отображение для указанного ключа.containsKey
в интерфейсе Map<K,V>
containsKey
в class AbstractMap<K,V>
key
- ключ, присутствие которого в этой карте должно быть протестированоtrue
если эта карта содержит отображение для указанного ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic boolean containsValue(Object value)
true
если эта карта отображает один или более ключей на указанное значение. Более формально, возвраты true
если и только если эта карта содержит по крайней мере одно отображение на значение v
так, что (value==null ? v==null : value.equals(v))
. Эта работа, вероятно, потребует времени, линейного в размере карты для большинства реализаций.containsValue
в интерфейсе Map<K,V>
containsValue
в class AbstractMap<K,V>
value
- оцените, чье присутствие в этой карте должно быть протестированоtrue
если отображение на value
существует; false
иначеpublic V get(Object key)
null
если эта карта не содержит отображения для ключа. Более формально, если эта карта содержит отображение от ключа k
к значению v
так, что key
сравнивается равный k
согласно упорядочиванию карты, тогда этот метод возвраты v
; иначе это возвращается null
. (Может быть самое большее одно такое отображение.)
Возвращаемое значение null
не обязательно указывает, что карта не содержит отображения для ключа; также возможно, что карта явно отображает ключ на null
. containsKey
работа может использоваться, чтобы отличить эти два случая.
get
в интерфейсе Map<K,V>
get
в class AbstractMap<K,V>
key
- ключ, присваиваемое значение которого должно быть возвращеноnull
если эта карта не содержит отображения для ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic Comparator<? super K> comparator()
SortedMap
null
если эта карта использует естественное упорядочивание своих ключей.comparator
в интерфейсе SortedMap<K,V>
null
если эта карта использует естественное упорядочивание своих ключейpublic K firstKey()
SortedMap
firstKey
в интерфейсе SortedMap<K,V>
NoSuchElementException
- если эта карта пустаpublic K lastKey()
SortedMap
lastKey
в интерфейсе SortedMap<K,V>
NoSuchElementException
- если эта карта пустаpublic void putAll(Map<? extends K,? extends V> map)
putAll
в интерфейсе Map<K,V>
putAll
в class AbstractMap<K,V>
map
- отображения, которые будут сохранены в этой картеClassCastException
- если class ключа или значения в указанной карте препятствует тому, чтобы это было сохранено в этой картеNullPointerException
- если указанная карта является нулем, или указанная карта содержит нулевой ключ, и эта карта не разрешает нулевые ключиpublic V put(K key, V value)
put
в интерфейсе Map<K,V>
put
в class AbstractMap<K,V>
key
- ключ, с которым должно быть связано указанное значениеvalue
- значение, которое будет связано с указанным ключомkey
, или null
если не было никакого отображения для key
. (A null
возврат может также указать что карта, ранее связанная null
с key
.)ClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic V remove(Object key)
remove
в интерфейсе Map<K,V>
remove
в class AbstractMap<K,V>
key
- ключ, для которого должно быть удалено отображениеkey
, или null
если не было никакого отображения для key
. (A null
возврат может также указать что карта, ранее связанная null
с key
.)ClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic void clear()
public Object clone()
TreeMap
экземпляр. (Ключи и сами значения не клонируются.)clone
в class AbstractMap<K,V>
Cloneable
public Map.Entry<K,V> firstEntry()
NavigableMap
null
если карта пуста.firstEntry
в интерфейсе NavigableMap<K,V>
null
если эта карта пустаpublic Map.Entry<K,V> lastEntry()
NavigableMap
null
если карта пуста.lastEntry
в интерфейсе NavigableMap<K,V>
null
если эта карта пустаpublic Map.Entry<K,V> pollFirstEntry()
NavigableMap
null
если карта пуста.pollFirstEntry
в интерфейсе NavigableMap<K,V>
null
если эта карта пустаpublic Map.Entry<K,V> pollLastEntry()
NavigableMap
null
если карта пуста.pollLastEntry
в интерфейсе NavigableMap<K,V>
null
если эта карта пустаpublic Map.Entry<K,V> lowerEntry(K key)
NavigableMap
null
если нет такого ключа.lowerEntry
в интерфейсе NavigableMap<K,V>
key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic K lowerKey(K key)
NavigableMap
null
если нет такого ключа.lowerKey
в интерфейсе NavigableMap<K,V>
key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic Map.Entry<K,V> floorEntry(K key)
NavigableMap
null
если нет такого ключа.floorEntry
в интерфейсе NavigableMap<K,V>
key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic K floorKey(K key)
NavigableMap
null
если нет такого ключа.floorKey
в интерфейсе NavigableMap<K,V>
key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic Map.Entry<K,V> ceilingEntry(K key)
NavigableMap
null
если нет такого ключа.ceilingEntry
в интерфейсе NavigableMap<K,V>
key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic K ceilingKey(K key)
NavigableMap
null
если нет такого ключа.ceilingKey
в интерфейсе NavigableMap<K,V>
key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic Map.Entry<K,V> higherEntry(K key)
NavigableMap
null
если нет такого ключа.higherEntry
в интерфейсе NavigableMap<K,V>
key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic K higherKey(K key)
NavigableMap
null
если нет такого ключа.higherKey
в интерфейсе NavigableMap<K,V>
key
- ключkey
, или null
если нет такого ключаClassCastException
- если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException
- если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic Set<K> keySet()
Set
представление ключей содержится в этой карте. iterator набора возвращает ключи в порядке по возрастанию. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме через собственный iterator's remove
работа), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove
, Set.remove
, removeAll
, retainAll
, и clear
операции. Это не поддерживает add
или addAll
операции.public NavigableSet<K> navigableKeySet()
NavigableMap
NavigableSet
представление ключей содержится в этой карте. iterator набора возвращает ключи в порядке по возрастанию. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме через собственный iterator's remove
работа), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove
, Set.remove
, removeAll
, retainAll
, и clear
операции. Это не поддерживает add
или addAll
операции.navigableKeySet
в интерфейсе NavigableMap<K,V>
public NavigableSet<K> descendingKeySet()
NavigableMap
NavigableSet
представление ключей содержится в этой карте. iterator набора возвращает ключи в порядке по убыванию. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме через собственный iterator's remove
работа), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove
, Set.remove
, removeAll
, retainAll
, и clear
операции. Это не поддерживает add
или addAll
операции.descendingKeySet
в интерфейсе NavigableMap<K,V>
public Collection<V> values()
Collection
представление значений содержится в этой карте. iterator набора возвращает значения в порядке возрастания соответствующих ключей. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме через собственный iterator's remove
работа), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove
, Collection.remove
, removeAll
, retainAll
и clear
операции. Это не поддерживает add
или addAll
операции.public Set<Map.Entry<K,V>> entrySet()
Set
представление отображений содержится в этой карте. iterator набора возвращает записи в возрастающем ключевом порядке. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме через собственный iterator's remove
работа, или через setValue
работа на записи карты, возвращенной iterator), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove
, Set.remove
, removeAll
, retainAll
и clear
операции. Это не поддерживает add
или addAll
операции.public NavigableMap<K,V> descendingMap()
NavigableMap
remove
работа), результаты итерации неопределены. У возвращенной карты есть упорядочивание, эквивалентное Collections.reverseOrder
(comparator()). Выражение m.descendingMap().descendingMap()
возвращает представление m
чрезвычайно эквивалентный m
.
descendingMap
в интерфейсе NavigableMap<K,V>
public NavigableMap<K,V> subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive)
NavigableMap
fromKey
к toKey
. Если fromKey
и toKey
равны, возвращенная карта не пуста если fromInclusive
и toInclusive
оба истина. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException
на попытке вставить ключ за пределами его диапазона, или создать подкарту, любая из чей конечных точек лежат вне его диапазона.
subMap
в интерфейсе NavigableMap<K,V>
fromKey
- низкая конечная точка ключей в возвращенной картеfromInclusive
- true
если низкая конечная точка должна быть включена в возвращенное представлениеtoKey
- высокая конечная точка ключей в возвращенной картеtoInclusive
- true
если высокая конечная точка должна быть включена в возвращенное представлениеfromKey
к toKey
ClassCastException
- если fromKey
и toKey
не может быть по сравнению с друг другом, используя компаратор этой карты (или, если у карты нет никакого компаратора, используя естественное упорядочивание). Реализации, но не обязаны, может выдать это исключение если fromKey
или toKey
не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException
- если fromKey
или toKey
нуль, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиIllegalArgumentException
- если fromKey
больше чем toKey
; или если у этой самой карты есть ограниченный диапазон, и fromKey
или toKey
находится вне границ диапазонаpublic NavigableMap<K,V> headMap(K toKey, boolean inclusive)
NavigableMap
inclusive
истина), toKey
. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException
на попытке вставить ключевую внешнюю сторону ее диапазон.
headMap
в интерфейсе NavigableMap<K,V>
toKey
- высокая конечная точка ключей в возвращенной картеinclusive
- true
если высокая конечная точка должна быть включена в возвращенное представлениеinclusive
истина), toKey
ClassCastException
- если toKey
не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если toKey
не реализует Comparable
). Реализации, но не обязаны, может выдать это исключение если toKey
не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException
- если toKey
нуль, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиIllegalArgumentException
- если у этой самой карты есть ограниченный диапазон, и toKey
находится вне границ диапазонаpublic NavigableMap<K,V> tailMap(K fromKey, boolean inclusive)
NavigableMap
inclusive
истина), fromKey
. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException
на попытке вставить ключевую внешнюю сторону ее диапазон.
tailMap
в интерфейсе NavigableMap<K,V>
fromKey
- низкая конечная точка ключей в возвращенной картеinclusive
- true
если низкая конечная точка должна быть включена в возвращенное представлениеinclusive
истина), fromKey
ClassCastException
- если fromKey
не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если fromKey
не реализует Comparable
). Реализации, но не обязаны, может выдать это исключение если fromKey
не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException
- если fromKey
нуль, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиIllegalArgumentException
- если у этой самой карты есть ограниченный диапазон, и fromKey
находится вне границ диапазонаpublic SortedMap<K,V> subMap(K fromKey, K toKey)
NavigableMap
fromKey
, включительно, к toKey
, монопольный. (Если fromKey
и toKey
равны, возвращенная карта пуста.) Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException
на попытке вставить ключевую внешнюю сторону ее диапазон.
Эквивалентный subMap(fromKey, true, toKey, false)
.
subMap
в интерфейсе NavigableMap<K,V>
subMap
в интерфейсе SortedMap<K,V>
fromKey
- низкая конечная точка (включительно) ключей в возвращенной картеtoKey
- высокая конечная точка (монопольная) из ключей в возвращенной картеfromKey
, включительно, к toKey
, монопольныйClassCastException
- если fromKey
и toKey
не может быть по сравнению с друг другом, используя компаратор этой карты (или, если у карты нет никакого компаратора, используя естественное упорядочивание). Реализации, но не обязаны, может выдать это исключение если fromKey
или toKey
не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException
- если fromKey
или toKey
нуль, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиIllegalArgumentException
- если fromKey
больше чем toKey
; или если у этой самой карты есть ограниченный диапазон, и fromKey
или toKey
находится вне границ диапазонаpublic SortedMap<K,V> headMap(K toKey)
NavigableMap
toKey
. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException
на попытке вставить ключевую внешнюю сторону ее диапазон.
Эквивалентный headMap(toKey, false)
.
headMap
в интерфейсе NavigableMap<K,V>
headMap
в интерфейсе SortedMap<K,V>
toKey
- высокая конечная точка (монопольная) из ключей в возвращенной картеtoKey
ClassCastException
- если toKey
не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если toKey
не реализует Comparable
). Реализации, но не обязаны, может выдать это исключение если toKey
не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException
- если toKey
нуль, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиIllegalArgumentException
- если у этой самой карты есть ограниченный диапазон, и toKey
находится вне границ диапазонаpublic SortedMap<K,V> tailMap(K fromKey)
NavigableMap
fromKey
. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException
на попытке вставить ключевую внешнюю сторону ее диапазон.
Эквивалентный tailMap(fromKey, true)
.
tailMap
в интерфейсе NavigableMap<K,V>
tailMap
в интерфейсе SortedMap<K,V>
fromKey
- низкая конечная точка (включительно) ключей в возвращенной картеfromKey
ClassCastException
- если fromKey
не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если fromKey
не реализует Comparable
). Реализации, но не обязаны, может выдать это исключение если fromKey
не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException
- если fromKey
нуль, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиIllegalArgumentException
- если у этой самой карты есть ограниченный диапазон, и fromKey
находится вне границ диапазона
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92