compact1, compact2, compact3

java.util.concurrent

Класс ConcurrentSkipListMap <K, V>

java.lang. Объект

java.util. AbstractMap<K, V>

java.util.concurrent.ConcurrentSkipListMap<K,V>

Введите Параметры:

K - тип ключей сохраняется этой картой

V - тип отображенных значений

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable, ConcurrentMap <K, V>, ConcurrentNavigableMap <K, V>, Карта <K, V>, NavigableMap <K, V>, SortedMap <K, V>

public class ConcurrentSkipListMap<K,V>
extends AbstractMap<K,V>
implements ConcurrentNavigableMap<K,V>, Cloneable, Serializable

Масштабируемое параллельное ConcurrentNavigableMap реализация. Карта сортируется согласно естественному упорядочиванию ее ключей, или a Comparator если во время создания карты, в зависимости от которого используется конструктор.

Этот class реализует параллельную разновидность SkipLists, обеспечивающего ожидаемый средний журнал (n) стоимость времени для containsKey, get, put и операций remove и их разновидностей. Вставка, удаление, обновление, и операции доступа безопасно выполняются одновременно многократными потоками. Iterators являются слабо непротиворечивыми, возвращая элементы, отражающие состояние карты в некоторый момент в или начиная с создания iterator. Они не бросают ConcurrentModificationException, и может продолжиться одновременно с другими операциями. Возрастающий ключ, упорядоченный представления и их iterators, быстрее чем убывающие.

Все пары Map.Entry, возвращенные методами в этом class и его представлениях, представляют снимки отображений в то время, когда они были произведены. Они не поддерживают метод Entry.setValue. (Отметьте однако, что возможно изменить отображения в связанной карте, используя put, putIfAbsent, или replace, в зависимости от точно, в каком эффекте Вы нуждаетесь.)

Остерегайтесь этого, в отличие от этого в большинстве наборов, метод size не является постоянно-разовой работой. Из-за асинхронной природы этих карт, определяя текущее число элементов требует обхода элементов, и так может сообщить о неточных результатах, если этот набор изменяется во время обхода. Дополнительно, объемные операции putAll, equals, toArray, containsValue, и clear, как гарантируют, не будут выполнены атомарно. Например, iterator, работающий одновременно с работой putAll, мог бы просмотреть только некоторые из добавленных элементов.

Этот class и его представления и iterators реализуют все дополнительные методы Map и Iterator интерфейсы. Как большинство других параллельных наборов, этот class не разрешает использование ключей null или значений, потому что некоторые нулевые возвращаемые значения нельзя достоверно отличить от отсутствия элементов.

Этот class является элементом Платформы Наборов Java.

С тех пор:

1.6

См. Также:

Сериализированная Форма

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

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

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

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

Map.Entry<K,V>

Сводка конструктора

Конструкторы

Конструктор и Описание
ConcurrentSkipListMap() Создает новую, пустую карту, сортированную согласно естественному упорядочиванию ключей.
ConcurrentSkipListMap(Comparator<? super K> comparator) Создает новую, пустую карту, сортированную согласно указанному компаратору.
ConcurrentSkipListMap(Map<? extends K,? extends V> m) Создает новую карту, содержащую те же самые отображения как данная карта, сортированная согласно естественному упорядочиванию ключей.
ConcurrentSkipListMap(SortedMap<K,? extends V> m) Создает новую карту, содержащую те же самые отображения и использующую то же самое упорядочивание в качестве указанной сортированной карты.

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

Модификатор и Тип	Метод и Описание
Map.Entry<K,V>	ceilingEntry(K key) Возвращает отображение значения ключа, связанное с наименее ключевым большим чем или равный данному ключу, или null, если нет такой записи.
K	ceilingKey(K key) Возвращает наименее ключевое большее чем или равный данному ключу, или null если нет такого ключа.
void	clear() Удаляет все отображения из этой карты.
ConcurrentSkipListMap<K,V>	clone() Возвращает мелкую копию этого экземпляра ConcurrentSkipListMap.
Comparator<? super K>	comparator() Возвращает компаратор, используемый, чтобы упорядочить ключи в этой карте, или null если эта карта использует естественное упорядочивание своих ключей.
boolean	containsKey(Object key) true возвратов, если эта карта содержит отображение для указанного ключа.
boolean	containsValue(Object value) true возвратов, если эта карта отображает один или более ключей на указанное значение.
NavigableSet<K>	descendingKeySet() Возвращает обратный порядок NavigableSet представление ключей содержится в этой карте.
ConcurrentNavigableMap<K,V>	descendingMap() Возвращает представление обратного порядка отображений, содержавшихся в этой карте.
Set<Map.Entry<K,V>>	entrySet() Возвраты a Set представление отображений содержится в этой карте.
boolean	equals(Object o) Сравнивает указанный объект с этой картой для равенства.
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 если эта карта не содержит отображения для ключа.
ConcurrentNavigableMap<K,V>	headMap(K toKey) Возвращает представление части этой карты, ключи которой являются строго меньше чем toKey.
ConcurrentNavigableMap<K,V>	headMap(K toKey, boolean inclusive) Возвращает представление части этой карты, ключи которой являются меньше чем (или равный, если inclusive истина), toKey.
Map.Entry<K,V>	higherEntry(K key) Возвращает отображение значения ключа, связанное с наименее ключевым, строго больше чем данный ключ, или null, если нет такого ключа.
K	higherKey(K key) Возвращает наименее ключевое, строго больше чем данный ключ, или null если нет такого ключа.
boolean	isEmpty() true возвратов, если эта карта не содержит отображений значения ключа.
NavigableSet<K>	keySet() Возвраты a NavigableSet представление ключей содержится в этой карте.
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) Связывает указанное значение с указанным ключом в этой карте.
V	putIfAbsent(K key, V value) Если указанный ключ уже не связывается со значением, свяжите его с данным значением.
V	remove(Object key) Удаляет отображение для указанного ключа из этой карты если существующий.
boolean	remove(Object key, Object value) Удаляет запись для ключа только если в настоящий момент отображенный на данное значение.
V	replace(K key, V value) Заменяет запись для ключа только если в настоящий момент отображенный на некоторое значение.
boolean	replace(K key, V oldValue, V newValue) Заменяет запись для ключа только если в настоящий момент отображенный на данное значение.
int	size() Возвращает число отображений значения ключа в этой карте.
ConcurrentNavigableMap<K,V>	subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive) Возвращает представление части этой карты, ключи которой располагаются от fromKey к toKey.
ConcurrentNavigableMap<K,V>	subMap(K fromKey, K toKey) Возвращает представление части этой карты, ключи которой располагаются от fromKey, включительно, к toKey, монопольный.
ConcurrentNavigableMap<K,V>	tailMap(K fromKey) Возвращает представление части этой карты, ключи которой больше чем или равны fromKey.
ConcurrentNavigableMap<K,V>	tailMap(K fromKey, boolean inclusive) Возвращает представление части этой карты, ключи которой больше чем (или равны, если inclusive истина), fromKey.
Collection<V>	values() Возвраты a Collection представление значений содержится в этой карте.

Методы, наследованные от class java.util. AbstractMap

hashCode, putAll, toString

Методы, наследованные от class java.lang. Объект

finalize, getClass, notify, notifyAll, wait, wait, wait

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

getOrDefault

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

compute, computeIfAbsent, computeIfPresent, forEach, hashCode, merge, putAll, replaceAll

Деталь конструктора

ConcurrentSkipListMap

public ConcurrentSkipListMap()

Создает новую, пустую карту, сортированную согласно естественному упорядочиванию ключей.

ConcurrentSkipListMap

public ConcurrentSkipListMap(Comparator<? super K> comparator)

Создает новую, пустую карту, сортированную согласно указанному компаратору.

Параметры:

comparator - компаратор, который будет использоваться, чтобы упорядочить эту карту. Если null, естественное упорядочивание ключей будет использоваться.

ConcurrentSkipListMap

public ConcurrentSkipListMap(Map<? extends K,? extends V> m)

Создает новую карту, содержащую те же самые отображения как данная карта, сортированная согласно естественному упорядочиванию ключей.

Параметры:

m - карта, отображения которой должны быть помещены в эту карту

Броски:

ClassCastException - если ключи в m не Comparable, или не взаимно сопоставимы

NullPointerException - если указанная карта или какой-либо из ее ключей или значений являются нулем

ConcurrentSkipListMap

public ConcurrentSkipListMap(SortedMap<K,? extends V> m)

Создает новую карту, содержащую те же самые отображения и использующую то же самое упорядочивание в качестве указанной сортированной карты.

Параметры:

m - сортированная карта, отображения которой должны быть помещены в эту карту, и чей компаратор должен использоваться, чтобы сортировать эту карту

Броски:

NullPointerException - если указанная сортированная карта или какой-либо из ее ключей или значений являются нулем

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

клон

public ConcurrentSkipListMap<K,V> clone()

Возвращает мелкую копию этого экземпляра ConcurrentSkipListMap. (Ключи и сами значения не клонируются.)

Переопределения:

clone в class AbstractMap<K,V>

Возвраты:

мелкая копия этой карты

См. Также:

Cloneable

containsKey

public boolean containsKey(Object key)

true возвратов, если эта карта содержит отображение для указанного ключа.

Определенный:

containsKey в интерфейсе Map<K,V>

Переопределения:

containsKey в class AbstractMap<K,V>

Параметры:

key - ключ, присутствие которого в этой карте должно быть протестировано

Возвраты:

true, если эта карта содержит отображение для указанного ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ является нулем

добраться

public V get(Object key)

Возвращает значение, на которое указанный ключ отображается, или null если эта карта не содержит отображения для ключа.

Более формально, если эта карта содержит отображение от ключа k к значению v так, что key сравнивается равный k согласно упорядочиванию карты, тогда этот метод возвраты v; иначе это возвращается null. (Может быть самое большее одно такое отображение.)

Определенный:

get в интерфейсе Map<K,V>

Переопределения:

get в class AbstractMap<K,V>

Параметры:

key - ключ, присваиваемое значение которого должно быть возвращено

Возвраты:

значение, на которое указанный ключ отображается, или null если эта карта не содержит отображения для ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ является нулем

поместить

public V put(K key,
             V value)

Связывает указанное значение с указанным ключом в этой карте. Если карта, ранее содержавшая отображение для ключа, старое значение заменяется.

Определенный:

put в интерфейсе Map<K,V>

Переопределения:

put в class AbstractMap<K,V>

Параметры:

key - ключ, с которым должно быть связано указанное значение

value - значение, которое будет связано с указанным ключом

Возвраты:

предыдущее значение, связанное с указанным ключом, или null, если не было никакого отображения для ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ или значение являются нулем

удалить

public V remove(Object key)

Удаляет отображение для указанного ключа из этой карты если существующий.

Определенный:

remove в интерфейсе Map<K,V>

Переопределения:

remove в class AbstractMap<K,V>

Параметры:

key - ключ, для которого должно быть удалено отображение

Возвраты:

предыдущее значение, связанное с указанным ключом, или null, если не было никакого отображения для ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ является нулем

containsValue

public boolean containsValue(Object value)

true возвратов, если эта карта отображает один или более ключей на указанное значение. Эта работа требует времени, линейного в размере карты. Дополнительно, для карты возможно измениться во время выполнения этого метода, когда возвращенный результат может быть неточным.

Определенный:

containsValue в интерфейсе Map<K,V>

Переопределения:

containsValue в class AbstractMap<K,V>

Параметры:

value - оцените, чье присутствие в этой карте должно быть протестировано

Возвраты:

true, если отображение на value существует; false иначе

Броски:

NullPointerException - если указанное значение является нулем

размер

public int size()

Возвращает число отображений значения ключа в этой карте. Если эта карта содержит больше чем элементы Integer.MAX_VALUE, она возвращает Integer.MAX_VALUE.

Остерегайтесь этого, в отличие от этого в большинстве наборов, этот метод НЕ является постоянно-разовой работой. Из-за асинхронной природы этих карт, определяя текущее число элементов требует, чтобы пересечение их всех считало их. Дополнительно, для размера возможно измениться во время выполнения этого метода, когда возвращенный результат будет неточен. Таким образом этот метод обычно не очень полезен в параллельных приложениях.

Определенный:

size в интерфейсе Map<K,V>

Переопределения:

size в class AbstractMap<K,V>

Возвраты:

число элементов в этой карте

isEmpty

public boolean isEmpty()

true возвратов, если эта карта не содержит отображений значения ключа.

Определенный:

isEmpty в интерфейсе Map<K,V>

Переопределения:

isEmpty в class AbstractMap<K,V>

Возвраты:

true, если эта карта не содержит отображений значения ключа

очистить

public void clear()

Удаляет все отображения из этой карты.

Определенный:

clear в интерфейсе Map<K,V>

Переопределения:

clear в class AbstractMap<K,V>

набор ключей

public NavigableSet<K> keySet()

Возвраты a NavigableSet представление ключей содержится в этой карте. iterator набора возвращает ключи в порядке по возрастанию. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll, и clear операции. Это не поддерживает add или addAll операции.

Представление iterator "слабо непротиворечивое" iterator, который никогда не будет бросать ConcurrentModificationException, и гарантии, чтобы пересечь элементы, поскольку они существовали на конструкцию iterator, и может (но не гарантироваться), отражают любые модификации, последующие за конструкцией.

Этот метод эквивалентен методу navigableKeySet.

Определенный:

keySet в интерфейсе ConcurrentNavigableMap<K,V>

Определенный:

keySet в интерфейсе Map<K,V>

Определенный:

keySet в интерфейсе SortedMap<K,V>

Переопределения:

keySet в class AbstractMap<K,V>

Возвраты:

судоходное представление набора ключей в этой карте

navigableKeySet

public NavigableSet<K> navigableKeySet()

Описание скопировало с интерфейса: ConcurrentNavigableMap

Возвраты a NavigableSet представление ключей содержится в этой карте. iterator набора возвращает ключи в порядке по возрастанию. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll, и clear операции. Это не поддерживает add или addAll операции.

Представление iterator "слабо непротиворечивое" iterator, который никогда не будет бросать ConcurrentModificationException, и гарантии, чтобы пересечь элементы, поскольку они существовали на конструкцию iterator, и может (но не гарантироваться), отражают любые модификации, последующие за конструкцией.

Определенный:

navigableKeySet в интерфейсе ConcurrentNavigableMap<K,V>

Определенный:

navigableKeySet в интерфейсе NavigableMap<K,V>

Возвраты:

судоходное представление набора ключей в этой карте

значения

public Collection<V> values()

Возвраты a Collection представление значений содержится в этой карте. iterator набора возвращает значения в порядке возрастания соответствующих ключей. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Collection.remove, removeAll, retainAll и операции clear. Это не поддерживает операции addAll или add.

iterator представления "слабо непротиворечивый" iterator, который никогда не будет бросать ConcurrentModificationException, и гарантии, чтобы пересечь элементы, поскольку они существовали на конструкцию iterator, и может (но не гарантироваться), отражают любые модификации, последующие за конструкцией.

Определенный:

values в интерфейсе Map<K,V>

Определенный:

values в интерфейсе SortedMap<K,V>

Переопределения:

values в class AbstractMap<K,V>

Возвраты:

представление набора значений содержится в этой карте

entrySet

public Set<Map.Entry<K,V>> entrySet()

Возвраты a Set представление отображений содержится в этой карте. iterator набора возвращает записи в возрастающем ключевом порядке. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll и операции clear. Это не поддерживает операции addAll или add.

iterator представления "слабо непротиворечивый" iterator, который никогда не будет бросать ConcurrentModificationException, и гарантии, чтобы пересечь элементы, поскольку они существовали на конструкцию iterator, и может (но не гарантироваться), отражают любые модификации, последующие за конструкцией.

Элементы Map.Entry, возвращенные iterator.next(), не поддерживают работу setValue.

Определенный:

entrySet в интерфейсе Map<K,V>

Определенный:

entrySet в интерфейсе SortedMap<K,V>

Определенный:

entrySet в class AbstractMap<K,V>

Возвраты:

представление набора отображений, содержавшихся в этой карте, сортированной в возрастающем ключевом порядке

descendingMap

public ConcurrentNavigableMap<K,V> descendingMap()

Описание скопировало с интерфейса: ConcurrentNavigableMap

Возвращает представление обратного порядка отображений, содержавшихся в этой карте. Убывающая карта поддерживается этой картой, так изменения к карте отражаются в убывающей карте, и наоборот.

У возвращенной карты есть упорядочивание, эквивалентное Collections.reverseOrder(comparator()). Выражение m.descendingMap().descendingMap() возвращает представление m чрезвычайно эквивалентный m.

Определенный:

descendingMap в интерфейсе ConcurrentNavigableMap<K,V>

Определенный:

descendingMap в интерфейсе NavigableMap<K,V>

Возвраты:

представление обратного порядка этой карты

descendingKeySet

public NavigableSet<K> descendingKeySet()

Описание скопировало с интерфейса: ConcurrentNavigableMap

Возвращает обратный порядок NavigableSet представление ключей содержится в этой карте. iterator набора возвращает ключи в порядке по убыванию. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll, и clear операции. Это не поддерживает add или addAll операции.

Представление iterator "слабо непротиворечивое" iterator, который никогда не будет бросать ConcurrentModificationException, и гарантии, чтобы пересечь элементы, поскольку они существовали на конструкцию iterator, и может (но не гарантироваться), отражают любые модификации, последующие за конструкцией.

Определенный:

descendingKeySet в интерфейсе ConcurrentNavigableMap<K,V>

Определенный:

descendingKeySet в интерфейсе NavigableMap<K,V>

Возвраты:

обратный порядок судоходное представление набора ключей в этой карте

равняется

public boolean equals(Object o)

Сравнивает указанный объект с этой картой для равенства. Возвраты true, если данный объект является также картой и двумя картами, представляют те же самые отображения. Более формально две карты m1 и m2 представляют те же самые отображения если m1.entrySet().equals(m2.entrySet()). Эта работа может возвратить вводящие в заблуждение результаты, если любая карта одновременно изменяется во время выполнения этого метода.

Определенный:

equals в интерфейсе Map<K,V>

Переопределения:

equals в class AbstractMap<K,V>

Параметры:

o - объект, который будет сравнен для равенства с этой картой

Возвраты:

true, если указанный объект равен этой карте

См. Также:

Object.hashCode(), HashMap

putIfAbsent

public V putIfAbsent(K key,
                     V value)

Если указанный ключ уже не связывается со значением, свяжите его с данным значением. Это эквивалентно

 
 if (!map.containsKey(key))
   return map.put(key, value);
 else
   return map.get(key);

за исключением того, что действие выполняется атомарно.

Определенный:

putIfAbsent в интерфейсе ConcurrentMap<K,V>

Определенный:

putIfAbsent в интерфейсе Map<K,V>

Параметры:

key - ключ, с которым должно быть связано указанное значение

value - значение, которое будет связано с указанным ключом

Возвраты:

предыдущее значение, связанное с указанным ключом, или null, если не было никакого отображения для ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ или значение являются нулем

удалить

public boolean remove(Object key,
                      Object value)

Удаляет запись для ключа только если в настоящий момент отображенный на данное значение. Это эквивалентно

 
 if (map.containsKey(key) && Objects.equals(map.get(key), value)) {
   map.remove(key);
   return true;
 } else
   return false;

за исключением того, что действие выполняется атомарно.

Определенный:

remove в интерфейсе ConcurrentMap<K,V>

Определенный:

remove в интерфейсе Map<K,V>

Параметры:

key - ключ, с которым связывается указанное значение

value - значение, которое, как ожидают, будет связано с указанным ключом

Возвраты:

true если значение было удалено

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ является нулем

замена

public boolean replace(K key,
                       V oldValue,
                       V newValue)

Заменяет запись для ключа только если в настоящий момент отображенный на данное значение. Это эквивалентно

 
 if (map.containsKey(key) && Objects.equals(map.get(key), oldValue)) {
   map.put(key, newValue);
   return true;
 } else
   return false;

за исключением того, что действие выполняется атомарно.

Определенный:

replace в интерфейсе ConcurrentMap<K,V>

Определенный:

replace в интерфейсе Map<K,V>

Параметры:

key - ключ, с которым связывается указанное значение

oldValue - значение, которое, как ожидают, будет связано с указанным ключом

newValue - значение, которое будет связано с указанным ключом

Возвраты:

true если значение было заменено

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если каким-либо из параметров является нуль

замена

public V replace(K key,
                 V value)

Заменяет запись для ключа только если в настоящий момент отображенный на некоторое значение. Это эквивалентно

 
 if (map.containsKey(key)) {
   return map.put(key, value);
 } else
   return null;

за исключением того, что действие выполняется атомарно.

Определенный:

replace в интерфейсе ConcurrentMap<K,V>

Определенный:

replace в интерфейсе Map<K,V>

Параметры:

key - ключ, с которым связывается указанное значение

value - значение, которое будет связано с указанным ключом

Возвраты:

предыдущее значение, связанное с указанным ключом, или null, если не было никакого отображения для ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ или значение являются нулем

компаратор

public Comparator<? super K> comparator()

Описание скопировало с интерфейса: SortedMap

Возвращает компаратор, используемый, чтобы упорядочить ключи в этой карте, или null если эта карта использует естественное упорядочивание своих ключей.

Определенный:

comparator в интерфейсе SortedMap<K,V>

Возвраты:

компаратор, используемый, чтобы упорядочить ключи в этой карте, или null если эта карта использует естественное упорядочивание своих ключей

firstKey

public K firstKey()

Описание скопировало с интерфейса: SortedMap

Возвращает первый (самый низкий) ключ в настоящий момент в этой карте.

Определенный:

firstKey в интерфейсе SortedMap<K,V>

Возвраты:

первый (самый низкий) ключ в настоящий момент в этой карте

Броски:

NoSuchElementException - если эта карта пуста

lastKey

public K lastKey()

Описание скопировало с интерфейса: SortedMap

Возвращает последний (самый высокий) ключ в настоящий момент в этой карте.

Определенный:

lastKey в интерфейсе SortedMap<K,V>

Возвраты:

последний (самый высокий) ключ в настоящий момент в этой карте

Броски:

NoSuchElementException - если эта карта пуста

подкарта

public ConcurrentNavigableMap<K,V> subMap(K fromKey,
                                          boolean fromInclusive,
                                          K toKey,
                                          boolean toInclusive)

Описание скопировало с интерфейса: NavigableMap

Возвращает представление части этой карты, ключи которой располагаются от fromKey к toKey. Если fromKey и toKey равны, возвращенная карта не пуста если fromInclusive и toInclusive оба истина. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта.

Возвращенная карта бросит IllegalArgumentException на попытке вставить ключ за пределами его диапазона, или создать подкарту, любая из чей конечных точек лежат вне его диапазона.

Определенный:

subMap в интерфейсе ConcurrentNavigableMap<K,V>

Определенный:

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 находится вне границ диапазона

headMap

public ConcurrentNavigableMap<K,V> headMap(K toKey,
                                           boolean inclusive)

Описание скопировало с интерфейса: NavigableMap

Возвращает представление части этой карты, ключи которой являются меньше чем (или равный, если inclusive истина), toKey. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта.

Возвращенная карта бросит IllegalArgumentException на попытке вставить ключевую внешнюю сторону ее диапазон.

Определенный:

headMap в интерфейсе ConcurrentNavigableMap<K,V>

Определенный:

headMap в интерфейсе NavigableMap<K,V>

Параметры:

toKey - высокая конечная точка ключей в возвращенной карте

inclusive - true если высокая конечная точка должна быть включена в возвращенное представление

Возвраты:

представление части этой карты, ключи которой являются меньше чем (или равный, если inclusive истина), toKey

Броски:

ClassCastException - если toKey не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если toKey не реализует Comparable). Реализации, но не обязаны, может выдать это исключение если toKey не может быть по сравнению с ключами в настоящий момент в карте.

NullPointerException - если toKey нуль

IllegalArgumentException - если у этой самой карты есть ограниченный диапазон, и toKey находится вне границ диапазона

tailMap

public ConcurrentNavigableMap<K,V> tailMap(K fromKey,
                                           boolean inclusive)

Описание скопировало с интерфейса: NavigableMap

Возвращает представление части этой карты, ключи которой больше чем (или равны, если inclusive истина), fromKey. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта.

Возвращенная карта бросит IllegalArgumentException на попытке вставить ключевую внешнюю сторону ее диапазон.

Определенный:

tailMap в интерфейсе ConcurrentNavigableMap<K,V>

Определенный:

tailMap в интерфейсе NavigableMap<K,V>

Параметры:

fromKey - низкая конечная точка ключей в возвращенной карте

inclusive - true если низкая конечная точка должна быть включена в возвращенное представление

Возвраты:

представление части этой карты, ключи которой больше чем (или равны, если inclusive истина), fromKey

Броски:

ClassCastException - если fromKey не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если fromKey не реализует Comparable). Реализации, но не обязаны, может выдать это исключение если fromKey не может быть по сравнению с ключами в настоящий момент в карте.

NullPointerException - если fromKey нуль

IllegalArgumentException - если у этой самой карты есть ограниченный диапазон, и fromKey находится вне границ диапазона

подкарта

public ConcurrentNavigableMap<K,V> subMap(K fromKey,
                                          K toKey)

Описание скопировало с интерфейса: NavigableMap

Возвращает представление части этой карты, ключи которой располагаются от fromKey, включительно, к toKey, монопольный. (Если fromKey и toKey равны, возвращенная карта пуста.) Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта.

Возвращенная карта бросит IllegalArgumentException на попытке вставить ключевую внешнюю сторону ее диапазон.

Эквивалентный subMap(fromKey, true, toKey, false).

Определенный:

subMap в интерфейсе ConcurrentNavigableMap<K,V>

Определенный:

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 находится вне границ диапазона

headMap

public ConcurrentNavigableMap<K,V> headMap(K toKey)

Описание скопировало с интерфейса: NavigableMap

Возвращает представление части этой карты, ключи которой являются строго меньше чем toKey. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта.

Возвращенная карта бросит IllegalArgumentException на попытке вставить ключевую внешнюю сторону ее диапазон.

Эквивалентный headMap(toKey, false).

Определенный:

headMap в интерфейсе ConcurrentNavigableMap<K,V>

Определенный:

headMap в интерфейсе NavigableMap<K,V>

Определенный:

headMap в интерфейсе SortedMap<K,V>

Параметры:

toKey - высокая конечная точка (монопольная) из ключей в возвращенной карте

Возвраты:

представление части этой карты, ключи которой являются строго меньше чем toKey

Броски:

ClassCastException - если toKey не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если toKey не реализует Comparable). Реализации, но не обязаны, может выдать это исключение если toKey не может быть по сравнению с ключами в настоящий момент в карте.

NullPointerException - если toKey нуль

IllegalArgumentException - если у этой самой карты есть ограниченный диапазон, и toKey находится вне границ диапазона

tailMap

public ConcurrentNavigableMap<K,V> tailMap(K fromKey)

Описание скопировало с интерфейса: NavigableMap

Возвращает представление части этой карты, ключи которой больше чем или равны fromKey. Возвращенная карта поддерживается этой картой, таким образом, изменения в возвращенной карте отражаются в этой карте, и наоборот. Возвращенная карта поддерживает все дополнительные операции карты, которые поддерживает эта карта.

Возвращенная карта бросит IllegalArgumentException на попытке вставить ключевую внешнюю сторону ее диапазон.

Эквивалентный tailMap(fromKey, true).

Определенный:

tailMap в интерфейсе ConcurrentNavigableMap<K,V>

Определенный:

tailMap в интерфейсе NavigableMap<K,V>

Определенный:

tailMap в интерфейсе SortedMap<K,V>

Параметры:

fromKey - низкая конечная точка (включительно) ключей в возвращенной карте

Возвраты:

представление части этой карты, ключи которой больше чем или равны fromKey

Броски:

ClassCastException - если fromKey не является совместимым с компаратором этой карты (или, если у карты нет никакого компаратора, если fromKey не реализует Comparable). Реализации, но не обязаны, может выдать это исключение если fromKey не может быть по сравнению с ключами в настоящий момент в карте.

NullPointerException - если fromKey нуль

IllegalArgumentException - если у этой самой карты есть ограниченный диапазон, и fromKey находится вне границ диапазона

lowerEntry

public Map.Entry<K,V> lowerEntry(K key)

Возвращает отображение значения ключа, связанное с самым большим ключом строго меньше чем данный ключ, или null, если нет такого ключа. Возвращенная запись не поддерживает метод Entry.setValue.

Определенный:

lowerEntry в интерфейсе NavigableMap<K,V>

Параметры:

key - ключ

Возвраты:

запись с самым большим ключом меньше чем key, или null если нет такого ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ является нулем

lowerKey

public K lowerKey(K key)

Описание скопировало с интерфейса: NavigableMap

Возвращает самый большой ключ строго меньше чем данный ключ, или null если нет такого ключа.

Определенный:

lowerKey в интерфейсе NavigableMap<K,V>

Параметры:

key - ключ

Возвраты:

самый большой ключ меньше чем key, или null если нет такого ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ является нулем

floorEntry

public Map.Entry<K,V> floorEntry(K key)

Возвращает отображение значения ключа, связанное с самым большим ключом, меньше чем или равным данному ключу, или null, если нет такого ключа. Возвращенная запись не поддерживает метод Entry.setValue.

Определенный:

floorEntry в интерфейсе NavigableMap<K,V>

Параметры:

key - ключ

Возвраты:

запись с самым большим ключом, меньше чем или равным key, или null если нет такого ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ является нулем

floorKey

public K floorKey(K key)

Описание скопировало с интерфейса: NavigableMap

Возвращает самый большой ключ, меньше чем или равный данному ключу, или null если нет такого ключа.

Определенный:

floorKey в интерфейсе NavigableMap<K,V>

Параметры:

key - ключ

Возвраты:

самый большой ключ, меньше чем или равный key, или null если нет такого ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ является нулем

ceilingEntry

public Map.Entry<K,V> ceilingEntry(K key)

Возвращает отображение значения ключа, связанное с наименее ключевым большим чем или равный данному ключу, или null, если нет такой записи. Возвращенная запись не поддерживает метод Entry.setValue.

Определенный:

ceilingEntry в интерфейсе NavigableMap<K,V>

Параметры:

key - ключ

Возвраты:

запись с наименее ключевым большим чем или равный key, или null если нет такого ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ является нулем

ceilingKey

public K ceilingKey(K key)

Описание скопировало с интерфейса: NavigableMap

Возвращает наименее ключевое большее чем или равный данному ключу, или null если нет такого ключа.

Определенный:

ceilingKey в интерфейсе NavigableMap<K,V>

Параметры:

key - ключ

Возвраты:

наименее ключевое большее чем или равный key, или null если нет такого ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ является нулем

higherEntry

public Map.Entry<K,V> higherEntry(K key)

Возвращает отображение значения ключа, связанное с наименее ключевым, строго больше чем данный ключ, или null, если нет такого ключа. Возвращенная запись не поддерживает метод Entry.setValue.

Определенный:

higherEntry в интерфейсе NavigableMap<K,V>

Параметры:

key - ключ

Возвраты:

запись с наименее ключевым большим чем key, или null если нет такого ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ является нулем

higherKey

public K higherKey(K key)

Описание скопировало с интерфейса: NavigableMap

Возвращает наименее ключевое, строго больше чем данный ключ, или null если нет такого ключа.

Определенный:

higherKey в интерфейсе NavigableMap<K,V>

Параметры:

key - ключ

Возвраты:

наименее ключевое большее чем key, или null если нет такого ключа

Броски:

ClassCastException - если указанный ключ не может быть по сравнению с ключами в настоящий момент в карте

NullPointerException - если указанный ключ является нулем

firstEntry

public Map.Entry<K,V> firstEntry()

Возвращает отображение значения ключа, связанное с наименьшим количеством ключа в этой карте, или null, если карта пуста. Возвращенная запись не поддерживает метод Entry.setValue.

Определенный:

firstEntry в интерфейсе NavigableMap<K,V>

Возвраты:

запись с наименее ключевым, или null если эта карта пуста

lastEntry

public Map.Entry<K,V> lastEntry()

Возвращает отображение значения ключа, связанное с самым большим ключом в этой карте, или null, если карта пуста. Возвращенная запись не поддерживает метод Entry.setValue.

Определенный:

lastEntry в интерфейсе NavigableMap<K,V>

Возвраты:

запись с самым большим ключом, или null если эта карта пуста

pollFirstEntry

public Map.Entry<K,V> pollFirstEntry()

Удаляет и возвращает отображение значения ключа, связанное с наименьшим количеством ключа в этой карте, или null, если карта пуста. Возвращенная запись не поддерживает метод Entry.setValue.

Определенный:

pollFirstEntry в интерфейсе NavigableMap<K,V>

Возвраты:

удаленная первая запись этой карты, или null если эта карта пуста

pollLastEntry

public Map.Entry<K,V> pollLastEntry()

Удаляет и возвращает отображение значения ключа, связанное с самым большим ключом в этой карте, или null, если карта пуста. Возвращенная запись не поддерживает метод Entry.setValue.

Определенный:

pollLastEntry в интерфейсе NavigableMap<K,V>

Возвраты:

удаленная последняя запись этой карты, или null если эта карта пуста