Spec-Zone.ru › OpenJDK 17

Класс ConcurrentSkipListMap<K,V>

java.lang.Object
java.util.AbstractMap<K,V>
java.util.concurrent.ConcurrentSkipListMap<K,V>
Type Parameters:
K - тип ключей, поддерживаемых этой картой
V - тип сопоставленных значений
All Implemented Interfaces:
Serializable, Cloneable, ConcurrentMap<K,V>, ConcurrentNavigableMap<K,V>, Map<K,V>, NavigableMap<K,V>, SortedMap<K,V> 
public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> implements ConcurrentNavigableMap<K,V>, Cloneable, Serializable
Масштабируемая потокобезопасная реализация ConcurrentNavigableMap. Карта упорядочена в соответствии с естественным порядком своих ключей или с помощью Comparator, предоставленного во время создания карты, в зависимости от используемого конструктора.

Этот класс реализует потокобезопасную версию списков обхода, обеспечивая ожидаемую среднюю стоимость log(n) для операций containsKey, get, put и remove и их вариантов. Вставки, удаления, обновления и операции доступа безопасно выполняются параллельно несколькими потоками.

Итераторы и разделители являются слабо согласованными.

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

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

Следует учитывать, что операции с набором putAll, equals, toArray, containsValue и clear не гарантируются как атомарные. Например, итератор, работающий параллельно с операцией putAll, может увидеть только некоторые добавленные элементы.

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

Этот класс является частью Java Collections Framework.

Since:
1.6
See Also:
  • Serialized Form

Краткое описание вложенных классов

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

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

Вложенные классы/интерфейсы, объявленные в интерфейсе java.util.Map

Map.Entry<K,V>

Краткое описание конструкторов

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

Краткое описание методов

Modifier and Type Method Описание
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 если это отображение использует естественный порядок сортировки своих ключей.
V compute(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)
Попытка вычислить сопоставление для указанного ключа и его текущего сопоставленного значения (или null если нет текущего сопоставления).
V computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction)
Если указанный ключ еще не связан со значением, пытается вычислить его значение с помощью заданной функции отображения и вводит его в это отображение, если null.
V computeIfPresent(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)
Если значение для указанного ключа присутствует, пытается вычислить новое сопоставление, учитывая ключ и его текущее сопоставленное значение.
boolean containsKey(Object key)
Возвращает true если это отображение содержит сопоставление для указанного ключа.
boolean containsValue(Object value)
Возвращает true если это отображение сопоставляет один или несколько ключей со значением.
NavigableSet<K> descendingKeySet()
Возвращает отображение в обратном порядке NavigableSet ключей, содержащихся в этом отображении.
ConcurrentNavigableMap<K,V> descendingMap()
Возвращает отображение в обратном порядке сопоставлений, содержащихся в этом отображении.
Set<Map.Entry<K,V>> entrySet()
Возвращает 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 если в этом отображении нет сопоставления для ключа.
V getOrDefault(Object key, V defaultValue)
Возвращает значение, которому сопоставлен указанный ключ, или заданное значение по умолчанию, если в этом отображении нет сопоставления для ключа.
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()
Возвращает NavigableSet представление ключей, содержащихся в этом отображении.
Map.Entry<K,V> lastEntry()
Возвращает сопоставление ключ-значение, связанное с наибольшим ключом в этом отображении, или null если отображение пустое.
K lastKey()
Возвращает последний (наибольший) ключ, в настоящее время присутствующий в этом отображении.
Map.Entry<K,V> lowerEntry(K key)
Возвращает сопоставление ключ-значение, связанное с наибольшим ключом, строго меньшим, чем заданный ключ, или null если такого ключа нет.
K lowerKey(K key)
Возвращает наибольший ключ, строго меньший, чем заданный ключ, или null если такого ключа нет.
V merge(K key, V value, BiFunction<? super V,? super V,? extends V> remappingFunction)
Если указанный ключ еще не связан со значением, связывает его с заданным значением.
NavigableSet<K> navigableKeySet()
Возвращает 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()
Возвращает Collection представление значений, содержащихся в этом отображении.

Методы, объявленные в классе java.util.AbstractMap

hashCode, isEmpty, putAll, size, toString

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

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

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

forEach, replaceAll

Методы, объявленные в интерфейсе java.util.Map

hashCode, putAll

Подробное описание конструкторов

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 - если указанная карта или любой из её ключей или значений равны null

ConcurrentSkipListMap

public ConcurrentSkipListMap(SortedMap<K,? extends V> m)
Создаёт новую карту, содержащую те же сопоставления и использующую тот же порядок, что и указанная отсортированная карта.
Параметры:
m - отсортированная карта, сопоставления которой должны быть помещены в эту карту, и компаратор которой должен быть использован для сортировки этой карты
Исключения:
NullPointerException - если указанная отсортированная карта или любой из её ключей или значений равны null

Подробное описание методов

clone

public ConcurrentSkipListMap<K,V> clone()
Возвращает поверхностную копию этого ConcurrentSkipListMap экземпляра. (Ключи и значения сами по себе не клонируются.)
Переопределяет:
clone в классе AbstractMap<K,V>
Возвращает:
поверхностную копию этой карты
См. также:
  • Cloneable

containsKey

public boolean containsKey(Object key)
Возвращает true , если эта карта содержит сопоставление для указанного ключа.
Указано в:
containsKey в интерфейсе Map<K,V>
Переопределяет:
containsKey в классе AbstractMap<K,V>
Параметры:
key - ключ, наличие которого в этой карте необходимо проверить
Возвращает:
true , если эта карта содержит сопоставление для указанного ключа
Исключения:
ClassCastException - если указанный ключ не может быть сравнен с ключами, имеющимися в карте
NullPointerException - если указанный ключ равен null

get

public V get(Object key)
Возвращает значение, которому соответствует указанный ключ, или null , если эта карта не содержит сопоставления для ключа.

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

Указано в:
get в интерфейсе Map<K,V>
Переопределяет:
get в классе AbstractMap<K,V>
Параметры:
key - ключ, связанное значение которого должно быть возвращено
Возвращает:
значение, которому соответствует указанный ключ, или null , если эта карта не содержит сопоставления для ключа
Исключения:
ClassCastException - если указанный ключ не может быть сравнен с ключами, имеющимися в карте
NullPointerException - если указанный ключ равен null

getOrDefault

public V getOrDefault(Object key, V defaultValue)
Возвращает значение, которому соответствует указанный ключ, или заданное defaultValue, если эта карта не содержит сопоставления для ключа.
Указано в:
getOrDefault в интерфейсе ConcurrentMap<K,V>
Указано в:
getOrDefault в интерфейсе Map<K,V>
Параметры:
key - ключ
defaultValue - значение, которое должно быть возвращено, если эта карта не содержит сопоставления для данного ключа
Возвращает:
сопоставление для ключа, если оно присутствует; иначе defaultValue
Исключения:
NullPointerException - если указанный ключ равен null
С тех пор как:
1.8

put

public V put(K key, V value)
Сопоставляет указанное значение с указанным ключом в этой карте. Если карта ранее содержала сопоставление для ключа, старое значение заменяется.
Указано в:
put в интерфейсе Map<K,V>
Переопределяет:
put в классе AbstractMap<K,V>
Параметры:
key - ключ, с которым должно быть сопоставлено указанное значение
value - значение, которое должно быть сопоставлено с указанным ключом
Возвращает:
предыдущее значение, связанное с указанным ключом, или null , если для ключа не было сопоставления
Исключения:
ClassCastException - если указанный ключ не может быть сравнен с ключами, имеющимися в карте
NullPointerException - если указанный ключ или значение равны null

remove

public V remove(Object key)
Удаляет сопоставление для указанного ключа из этой карты, если оно присутствует.
Указано в:
remove в интерфейсе Map<K,V>
Переопределяет:
remove в классе AbstractMap<K,V>
Параметры:
key - ключ, для которого должно быть удалено сопоставление
Возвращает:
предыдущее значение, связанное с указанным ключом, или null , если для ключа не было сопоставления
Исключения:
ClassCastException - если указанный ключ не может быть сравнен с ключами, имеющимися в карте
NullPointerException - если указанный ключ равен null

containsValue

public boolean containsValue(Object value)
Возвращает true , если эта карта сопоставляет один или несколько ключей со значением. Эта операция требует времени, линейного относительно размера карты. Кроме того, возможно изменение карты во время выполнения этого метода, в этом случае возвращаемый результат может быть неточным.
Указано в:
containsValue в интерфейсе Map<K,V>
Переопределяет:
containsValue в классе AbstractMap<K,V>
Параметры:
value - значение, наличие которого в этой карте необходимо проверить
Возвращает:
true , если существует сопоставление со значением value; false в противном случае
Исключения:
NullPointerException - если указанное значение равно null

size

public int size()
Возвращает количество пар ключ-значение в этой карте. Если карта содержит более Integer.MAX_VALUE элементов, возвращает Integer.MAX_VALUE.
Указано в:
size в интерфейсе Map<K,V>
Переопределяет:
size в классе AbstractMap<K,V>
Возвращает:
количество пар ключ-значение в этой карте

isEmpty

public boolean isEmpty()
Возвращает true , если эта карта не содержит пар ключ-значение.
Указано в:
isEmpty в интерфейсе Map<K,V>
Переопределяет:
isEmpty в классе AbstractMap<K,V>
Возвращает:
true , если эта карта не содержит пар ключ-значение

clear

public void clear()
Удаляет все сопоставления из этой карты.
Указано в:
clear в интерфейсе Map<K,V>
Переопределяет:
clear в классе AbstractMap<K,V>

computeIfAbsent

public V computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction)
Если указанный ключ ещё не связан со значением, пытается вычислить его значение с помощью заданной функции отображения и ввести его в эту карту, если null. Функция не гарантируется, что будет применена один раз атомарно, только если значение отсутствует.
Указано в:
computeIfAbsent в интерфейсе ConcurrentMap<K,V>
Указано в:
computeIfAbsent в интерфейсе Map<K,V>
Параметры:
key - ключ, с которым должно быть сопоставлено указанное значение
mappingFunction - функция для вычисления значения
Возвращает:
текущее (существующее или вычисленное) значение, связанное с указанным ключом, или null, если вычисленное значение равно null
Исключения:
NullPointerException - если указанный ключ или функция mappingFunction равны null
С тех пор как:
1.8

computeIfPresent

public V computeIfPresent(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)
Если значение для указанного ключа присутствует, пытается вычислить новое отображение, используя ключ и его текущее сопоставленное значение. Функция не гарантируется, что будет применена один раз атомарно.
Specified by:
computeIfPresent in interface ConcurrentMap<K,V>
Specified by:
computeIfPresent in interface Map<K,V>
Parameters:
key - ключ, с которым может быть связано значение
remappingFunction - функция для вычисления значения
Returns:
новое значение, связанное с указанным ключом, или null, если нет
Throws:
NullPointerException - если указанный ключ или функция переназначения равны null
Since:
1.8

compute

public V compute(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)
Пытается вычислить отображение для указанного ключа и его текущего сопоставленного значения (или null, если текущего отображения нет). Функция не гарантируется, что будет применена один раз атомарно.
Specified by:
compute in interface ConcurrentMap<K,V>
Specified by:
compute in interface Map<K,V>
Parameters:
key - ключ, с которым должно быть связано указанное значение
remappingFunction - функция для вычисления значения
Returns:
новое значение, связанное с указанным ключом, или null, если нет
Throws:
NullPointerException - если указанный ключ или функция переназначения равны null
Since:
1.8

merge

public V merge(K key, V value, BiFunction<? super V,? super V,? extends V> remappingFunction)
Если указанный ключ еще не связан со значением, связывает его с заданным значением. В противном случае, заменяет значение результатом заданной функции переназначения или удаляет, если null. Функция не гарантируется, что будет применена один раз атомарно.
Specified by:
merge in interface ConcurrentMap<K,V>
Specified by:
merge in interface Map<K,V>
Parameters:
key - ключ, с которым должно быть связано указанное значение
value - значение, используемое при отсутствии
remappingFunction - функция для повторного вычисления значения, если оно присутствует
Returns:
новое значение, связанное с указанным ключом, или null, если нет
Throws:
NullPointerException - если указанный ключ, значение или функция переназначения равны null
Since:
1.8

keySet

public NavigableSet<K> keySet()
Возвращает представление NavigableSet ключей, содержащихся в этом отображении.

Итератор набора возвращает ключи в порядке возрастания. Итератор набора также сообщает Spliterator.CONCURRENT, Spliterator.NONNULL, Spliterator.SORTED и Spliterator.ORDERED со встречным порядком, который является порядком возрастания ключей.

Компаратор итератора является null если компаратор отображения является null. В противном случае, компаратор итератора такой же, как или накладывает такое же полное упорядочивание, как и компаратор отображения.

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

Итераторы и итераторы представления являются слабо согласованными.

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

Specified by:
keySet in interface ConcurrentNavigableMap<K,V>
Specified by:
keySet in interface Map<K,V>
Specified by:
keySet in interface SortedMap<K,V>
Overrides:
keySet in class AbstractMap<K,V>
Returns:
представление navigable set ключей в этом отображении

navigableKeySet

public NavigableSet<K> navigableKeySet()
Описание скопировано из интерфейса: ConcurrentNavigableMap
Возвращает представление NavigableSet ключей, содержащихся в этом отображении. Итератор набора возвращает ключи в порядке возрастания. Набор поддерживается отображением, поэтому изменения в отображении отражаются в наборе, и наоборот. Набор поддерживает удаление элементов, что удаляет соответствующее отображение из отображения, через Iterator.remove, Set.remove, removeAll, retainAll, и clear операции. Он не поддерживает операции add или addAll.

Итераторы и итераторы представления являются слабо согласованными.

Specified by:
navigableKeySet in interface ConcurrentNavigableMap<K,V>
Specified by:
navigableKeySet in interface NavigableMap<K,V>
Returns:
представление navigable set ключей в этом отображении

values

public Collection<V> values()
Возвращает представление Collection значений, содержащихся в этом отображении.

Итератор коллекции возвращает значения в порядке возрастания соответствующих ключей. Итератор коллекции также сообщает Spliterator.CONCURRENT, Spliterator.NONNULL и Spliterator.ORDERED со встречным порядком, который является порядком возрастания соответствующих ключей.

Коллекция поддерживается отображением, поэтому изменения в отображении отражаются в коллекции, и наоборот. Коллекция поддерживает удаление элементов, что удаляет соответствующее отображение из отображения, через Iterator.remove, Collection.remove, removeAll, retainAll и clear операции. Он не поддерживает операции add или addAll.

Итераторы и итераторы представления являются слабо согласованными.

Specified by:
values in interface Map<K,V>
Specified by:
values in interface SortedMap<K,V>
Overrides:
values in class AbstractMap<K,V>
Returns:
представление коллекции значений, содержащихся в этом отображении

entrySet

public Set<Map.Entry<K,V>> entrySet()
Возвращает представление Set отображений, содержащихся в этом отображении.

Итератор набора возвращает записи в порядке возрастания ключей. Итератор набора также сообщает Spliterator.CONCURRENT, Spliterator.NONNULL, Spliterator.SORTED и Spliterator.ORDERED со встречным порядком, который является порядком возрастания ключей.

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

Элементы представления, проходящиеся итератором или итератором, не поддерживают операцию setValue.

Specified by:
entrySet in interface Map<K,V>
Specified by:
entrySet in interface SortedMap<K,V>
Returns:
представление множества отображений, содержащихся в этом отображении, отсортированное по возрастанию ключей

descendingMap

public ConcurrentNavigableMap<K,V> descendingMap()
Описание скопировано из интерфейса: ConcurrentNavigableMap
Возвращает представление отображений, содержащихся в этом отображении, в обратном порядке. Отображение в обратном порядке поддерживается этим отображением, поэтому изменения в отображении отражаются в отображении в обратном порядке, и наоборот.

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

Specified by:
descendingMap in interface ConcurrentNavigableMap<K,V>
Specified by:
descendingMap in interface NavigableMap<K,V>
Returns:
представление отображения в обратном порядке

descendingKeySet

public NavigableSet<K> descendingKeySet()
Описание скопировано из интерфейса: ConcurrentNavigableMap
Возвращает вид NavigableSet ключей, содержащихся в этой карте, в обратном порядке. Итератор набора возвращает ключи в порядке убывания. Набор поддерживается картой, поэтому изменения в карте отражаются в наборе и наоборот. Набор поддерживает удаление элементов, которое удаляет соответствующее отображение из карты, посредством операций Iterator.remove, Set.remove, removeAll, retainAll, и clear. Он не поддерживает операции add или addAll.

Итераторы и спиннеры представления являются слабо согласованными.

Определено в:
descendingKeySet в интерфейсе ConcurrentNavigableMap<K,V>
Определено в:
descendingKeySet в интерфейсе NavigableMap<K,V>
Возвращает:
представление навигационного набора ключей в обратном порядке в этой карте

equals

public boolean equals(Object o)
Сравнивает указанный объект с этой картой на равенство. Возвращает true , если данный объект также является картой, и две карты представляют одни и те же отображения. Более формально, две карты m1 и m2 представляют одни и те же отображения, если m1.entrySet().equals(m2.entrySet()). Эта операция может возвращать вводящие в заблуждение результаты, если либо карта модифицируется одновременно во время выполнения этого метода.
Определено в:
equals в интерфейсе Map<K,V>
Переопределяет:
equals в классе AbstractMap<K,V>
Параметры:
o - объект, который нужно сравнить на равенство с этой картой
Возвращает:
true , если указанный объект равен этой карте
См. также:
  • Object.hashCode()
  • HashMap

putIfAbsent

public V putIfAbsent(K key, V value)
Если указанный ключ еще не сопоставлен со значением, сопоставляет его с заданным значением. Это эквивалентно для этой map: 
 
 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 - если указанный ключ или значение null

remove

public boolean remove(Object key, Object value)
Удаляет запись для ключа только в том случае, если она в настоящее время сопоставлена ​​с заданным значением. Это эквивалентно для этой map: 
 
 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 - если указанный ключ null

replace

public boolean replace(K key, V oldValue, V newValue)
Заменяет запись для ключа только в том случае, если она в настоящее время сопоставлена ​​с заданным значением. Это эквивалентно для этой map: 
 
 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 - если любой из аргументов null

replace

public V replace(K key, V value)
Заменяет запись для ключа только в том случае, если она в настоящее время сопоставлена ​​с каким-либо значением. Это эквивалентно для этой map: 
 
 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 - если указанный ключ или значение null

comparator

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 - если эта карта пуста

subMap

public ConcurrentNavigableMap<K,V> subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive)
Описание скопировано из интерфейса: NavigableMap
Возвращает представление части этой карты, ключи которой находятся в диапазоне от fromKey до toKey. Если fromKey и toKey равны, возвращаемая карта пуста, если только fromInclusive и toInclusive оба равны true. Возвращаемая карта поддерживается этой картой, поэтому изменения в возвращаемой карте отражаются в этой карте и наоборот. Возвращаемая карта поддерживает все необязательные операции карты, которые поддерживает эта карта.

Возвращаемая карта будет выбрасывать 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 null
IllegalArgumentException - если fromKey больше, чем toKey; или если у этой карты есть ограниченный диапазон, и fromKey или toKey лежит за пределами границ диапазона
END_OF_DOCUMENT_MARKER

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 равно null
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 равно null
IllegalArgumentException - если эта карта сама имеет ограниченный диапазон, и fromKey находится за пределами диапазона

subMap

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 равно null
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 равно null
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 равно null
IllegalArgumentException - если эта карта сама имеет ограниченный диапазон, и fromKey находится за пределами диапазона

lowerEntry

public Map.Entry<K,V> lowerEntry(K key)
Возвращает сопоставление ключ-значение, связанное с наибольшим ключом, строго меньшим, чем заданный ключ, или null, если такого ключа нет. Возвращаемая запись не поддерживает метод Entry.setValue.
Указано в:
lowerEntry в интерфейсе NavigableMap<K,V>
Параметры:
key - ключ
Возвращает:
запись с наибольшим ключом, меньшим, чем key, или null, если такого ключа нет
Исключения:
ClassCastException - если указанный ключ не может быть сравнен с ключами, которые в настоящее время находятся в карте
NullPointerException - если указанный ключ равен null

lowerKey

public K lowerKey(K key)
Описание скопировано из интерфейса: NavigableMap
Возвращает наибольший ключ, строго меньший данного ключа, или null если такого ключа нет.
Указано в:
lowerKey в интерфейсе NavigableMap<K,V>
Параметры:
key - ключ
Возвращает:
наибольший ключ, меньший key, или null если такого ключа нет
Исключения:
ClassCastException - если заданный ключ нельзя сравнить с ключами, которые сейчас в карте
NullPointerException - если заданный ключ равен null

floorEntry

public Map.Entry<K,V> floorEntry(K key)
Возвращает сопоставление ключ-значение, связанное с наибольшим ключом, меньшим или равным заданному ключу, или null если такого ключа нет. Возвращаемая запись не поддерживает метод Entry.setValue.
Указано в:
floorEntry в интерфейсе NavigableMap<K,V>
Параметры:
key - ключ
Возвращает:
запись с наибольшим ключом, меньшим или равным key, или null если такого ключа нет
Исключения:
ClassCastException - если заданный ключ нельзя сравнить с ключами, которые сейчас в карте
NullPointerException - если заданный ключ равен null

floorKey

public K floorKey(K key)
Описание скопировано из интерфейса: NavigableMap
Возвращает наибольший ключ, меньший или равный заданному ключу, или null если такого ключа нет.
Указано в:
floorKey в интерфейсе NavigableMap<K,V>
Параметры:
key - ключ
Возвращает:
наибольший ключ, меньший или равный key, или null если такого ключа нет
Исключения:
ClassCastException - если заданный ключ нельзя сравнить с ключами, которые сейчас в карте
NullPointerException - если заданный ключ равен null

ceilingEntry

public Map.Entry<K,V> ceilingEntry(K key)
Возвращает сопоставление ключ-значение, связанное с наименьшим ключом, большим или равным заданному ключу, или null если такой записи нет. Возвращаемая запись не поддерживает метод Entry.setValue.
Указано в:
ceilingEntry в интерфейсе NavigableMap<K,V>
Параметры:
key - ключ
Возвращает:
запись с наименьшим ключом, большим или равным key, или null если такой записи нет
Исключения:
ClassCastException - если заданный ключ нельзя сравнить с ключами, которые сейчас в карте
NullPointerException - если заданный ключ равен null

ceilingKey

public K ceilingKey(K key)
Описание скопировано из интерфейса: NavigableMap
Возвращает наименьший ключ, больший или равный заданному ключу, или null если такого ключа нет.
Указано в:
ceilingKey в интерфейсе NavigableMap<K,V>
Параметры:
key - ключ
Возвращает:
наименьший ключ, больший или равный key, или null если такого ключа нет
Исключения:
ClassCastException - если заданный ключ нельзя сравнить с ключами, которые сейчас в карте
NullPointerException - если заданный ключ равен null

higherEntry

public Map.Entry<K,V> higherEntry(K key)
Возвращает сопоставление ключ-значение, связанное с наименьшим ключом, строго большим заданного ключа, или null если такого ключа нет. Возвращаемая запись не поддерживает метод Entry.setValue.
Указано в:
higherEntry в интерфейсе NavigableMap<K,V>
Параметры:
key - ключ
Возвращает:
запись с наименьшим ключом, большим key, или null если такого ключа нет
Исключения:
ClassCastException - если заданный ключ нельзя сравнить с ключами, которые сейчас в карте
NullPointerException - если заданный ключ равен null

higherKey

public K higherKey(K key)
Описание скопировано из интерфейса: NavigableMap
Возвращает наименьший ключ, строго больший заданного ключа, или null если такого ключа нет.
Указано в:
higherKey в интерфейсе NavigableMap<K,V>
Параметры:
key - ключ
Возвращает:
наименьший ключ, больший key, или null если такого ключа нет
Исключения:
ClassCastException - если заданный ключ нельзя сравнить с ключами, которые сейчас в карте
NullPointerException - если заданный ключ равен null

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 если эта карта пуста

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/concurrent/ConcurrentSkipListMap.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API