|
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, toStringfinalize, getClass, notify, notifyAll, wait, wait, waitcompute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, isEmpty, merge, putIfAbsent, remove, replace, replace, replaceAllpublic 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()
SortedMapnull если эта карта использует естественное упорядочивание своих ключей.comparator в интерфейсе SortedMap<K,V>null если эта карта использует естественное упорядочивание своих ключейpublic K firstKey()
SortedMapfirstKey в интерфейсе SortedMap<K,V>NoSuchElementException - если эта карта пустаpublic K lastKey()
SortedMaplastKey в интерфейсе 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>Cloneablepublic Map.Entry<K,V> firstEntry()
NavigableMapnull если карта пуста.firstEntry в интерфейсе NavigableMap<K,V>null если эта карта пустаpublic Map.Entry<K,V> lastEntry()
NavigableMapnull если карта пуста.lastEntry в интерфейсе NavigableMap<K,V>null если эта карта пустаpublic Map.Entry<K,V> pollFirstEntry()
NavigableMapnull если карта пуста.pollFirstEntry в интерфейсе NavigableMap<K,V>null если эта карта пустаpublic Map.Entry<K,V> pollLastEntry()
NavigableMapnull если карта пуста.pollLastEntry в интерфейсе NavigableMap<K,V>null если эта карта пустаpublic Map.Entry<K,V> lowerEntry(K key)
NavigableMapnull если нет такого ключа.lowerEntry в интерфейсе NavigableMap<K,V>key - ключkey, или null если нет такого ключаClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException - если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic K lowerKey(K key)
NavigableMapnull если нет такого ключа.lowerKey в интерфейсе NavigableMap<K,V>key - ключkey, или null если нет такого ключаClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException - если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic Map.Entry<K,V> floorEntry(K key)
NavigableMapnull если нет такого ключа.floorEntry в интерфейсе NavigableMap<K,V>key - ключkey, или null если нет такого ключаClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException - если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic K floorKey(K key)
NavigableMapnull если нет такого ключа.floorKey в интерфейсе NavigableMap<K,V>key - ключkey, или null если нет такого ключаClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException - если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic Map.Entry<K,V> ceilingEntry(K key)
NavigableMapnull если нет такого ключа.ceilingEntry в интерфейсе NavigableMap<K,V>key - ключkey, или null если нет такого ключаClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException - если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic K ceilingKey(K key)
NavigableMapnull если нет такого ключа.ceilingKey в интерфейсе NavigableMap<K,V>key - ключkey, или null если нет такого ключаClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException - если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic Map.Entry<K,V> higherEntry(K key)
NavigableMapnull если нет такого ключа.higherEntry в интерфейсе NavigableMap<K,V>key - ключkey, или null если нет такого ключаClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в картеNullPointerException - если указанный ключ является нулем, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиpublic K higherKey(K key)
NavigableMapnull если нет такого ключа.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()
NavigableMapNavigableSet представление ключей содержится в этой карте. iterator набора возвращает ключи в порядке по возрастанию. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме через собственный iterator's remove работа), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll, и clear операции. Это не поддерживает add или addAll операции.navigableKeySet в интерфейсе NavigableMap<K,V>public NavigableSet<K> descendingKeySet()
NavigableMapNavigableSet представление ключей содержится в этой карте. 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()
NavigableMapremove работа), результаты итерации неопределены. У возвращенной карты есть упорядочивание, эквивалентное 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)
NavigableMapfromKey к toKey. Если fromKey и toKey равны, возвращенная карта не пуста если fromInclusive и toInclusive оба истина. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException на попытке вставить ключ за пределами его диапазона, или создать подкарту, любая из чей конечных точек лежат вне его диапазона.
subMap в интерфейсе NavigableMap<K,V>fromKey - низкая конечная точка ключей в возвращенной картеfromInclusive - true если низкая конечная точка должна быть включена в возвращенное представлениеtoKey - высокая конечная точка ключей в возвращенной картеtoInclusive - true если высокая конечная точка должна быть включена в возвращенное представлениеfromKey к toKeyClassCastException - если fromKey и toKey не может быть по сравнению с друг другом, используя компаратор этой карты (или, если у карты нет никакого компаратора, используя естественное упорядочивание). Реализации, но не обязаны, может выдать это исключение если fromKey или toKey не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException - если fromKey или toKey нуль, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиIllegalArgumentException - если fromKey больше чем toKey; или если у этой самой карты есть ограниченный диапазон, и fromKey или toKey находится вне границ диапазонаpublic NavigableMap<K,V> headMap(K toKey, boolean inclusive)
NavigableMapinclusive истина), toKey. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException на попытке вставить ключевую внешнюю сторону ее диапазон.
headMap в интерфейсе NavigableMap<K,V>toKey - высокая конечная точка ключей в возвращенной картеinclusive - true если высокая конечная точка должна быть включена в возвращенное представлениеinclusive истина), toKeyClassCastException - если toKey не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если toKey не реализует Comparable). Реализации, но не обязаны, может выдать это исключение если toKey не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException - если toKey нуль, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиIllegalArgumentException - если у этой самой карты есть ограниченный диапазон, и toKey находится вне границ диапазонаpublic NavigableMap<K,V> tailMap(K fromKey, boolean inclusive)
NavigableMapinclusive истина), fromKey. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException на попытке вставить ключевую внешнюю сторону ее диапазон.
tailMap в интерфейсе NavigableMap<K,V>fromKey - низкая конечная точка ключей в возвращенной картеinclusive - true если низкая конечная точка должна быть включена в возвращенное представлениеinclusive истина), fromKeyClassCastException - если fromKey не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если fromKey не реализует Comparable). Реализации, но не обязаны, может выдать это исключение если fromKey не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException - если fromKey нуль, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиIllegalArgumentException - если у этой самой карты есть ограниченный диапазон, и fromKey находится вне границ диапазонаpublic SortedMap<K,V> subMap(K fromKey, K toKey)
NavigableMapfromKey, включительно, к 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)
NavigableMaptoKey. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException на попытке вставить ключевую внешнюю сторону ее диапазон.
Эквивалентный headMap(toKey, false).
headMap в интерфейсе NavigableMap<K,V>headMap в интерфейсе SortedMap<K,V>toKey - высокая конечная точка (монопольная) из ключей в возвращенной картеtoKeyClassCastException - если toKey не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если toKey не реализует Comparable). Реализации, но не обязаны, может выдать это исключение если toKey не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException - если toKey нуль, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиIllegalArgumentException - если у этой самой карты есть ограниченный диапазон, и toKey находится вне границ диапазонаpublic SortedMap<K,V> tailMap(K fromKey)
NavigableMapfromKey. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта. Возвращенная карта бросит IllegalArgumentException на попытке вставить ключевую внешнюю сторону ее диапазон.
Эквивалентный tailMap(fromKey, true).
tailMap в интерфейсе NavigableMap<K,V>tailMap в интерфейсе SortedMap<K,V>fromKey - низкая конечная точка (включительно) ключей в возвращенной картеfromKeyClassCastException - если fromKey не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если fromKey не реализует Comparable). Реализации, но не обязаны, может выдать это исключение если fromKey не может быть по сравнению с ключами в настоящий момент в карте.NullPointerException - если fromKey нуль, и эта карта использует естественное упорядочивание, или его компаратор не разрешает нулевые ключиIllegalArgumentException - если у этой самой карты есть ограниченный диапазон, и fromKey находится вне границ диапазона
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92