Интерфейс ConcurrentNavigableMap<K,V>

Параметры типа:: K — тип ключей, поддерживаемых этой картой; V — тип отображаемых значений

Все суперинтерфейсы:: ConcurrentMap<K,V>, Map<K,V>, NavigableMap<K,V>, SequencedMap<K,V>, SortedMap<K,V>

Все известные реализующие классы:: ConcurrentSkipListMap

public interface ConcurrentNavigableMap<K,V> extends ConcurrentMap<K,V>, NavigableMap<K,V>

Интерфейс ConcurrentMap, поддерживающий операции NavigableMap, а также такие операции для его навигационных под-карт.

Этот интерфейс входит в состав Java Collections Framework.

Начиная с версии:: 1.6

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

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

Map.Entry<K,V>

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

Модификатор и тип	Метод	Описание
`NavigableSet<K>`	`descendingKeySet()`	Возвращает представление ключей, содержащихся в этой карте, в обратном порядке в виде `NavigableSet`.
`ConcurrentNavigableMap<K,V>`	`descendingMap()`	Возвращает представление отображений, содержащихся в этой карте, в обратном порядке.
`ConcurrentNavigableMap<K,V>`	`headMap(K toKey)`	Возвращает представление части этой карты, ключи которой строго меньше `toKey`.
`ConcurrentNavigableMap<K,V>`	`headMap(K toKey, boolean inclusive)`	Возвращает представление части этой карты, ключи которой меньше `toKey` (или равны ему, если `inclusive` равно true).
`NavigableSet<K>`	`keySet()`	Возвращает представление ключей, содержащихся в этой карте, в виде `NavigableSet`.
`NavigableSet<K>`	`navigableKeySet()`	Возвращает представление ключей, содержащихся в этой карте, в виде `NavigableSet`.
`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)`	Возвращает представление части этой карты, ключи которой больше `fromKey` (или равны ему, если `inclusive` равно true).

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

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

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

clear, containsKey, containsValue, equals, get, hashCode, isEmpty, put, putAll, remove, size

Методы, объявленные в интерфейсе NavigableMap

ceilingEntry, ceilingKey, firstEntry, floorEntry, floorKey, higherEntry, higherKey, lastEntry, lowerEntry, lowerKey, pollFirstEntry, pollLastEntry, reversed

Методы, объявленные в интерфейсе SequencedMap

sequencedEntrySet, sequencedKeySet, sequencedValues

Методы, объявленные в интерфейсе SortedMap

comparator, entrySet, firstKey, lastKey, putFirst, putLast, values

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

subMap

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

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

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

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

Указано в:: subMap в интерфейсе NavigableMap<K,V>
Параметры:: fromKey — нижняя граница ключей возвращаемой карты; fromInclusive — true, если нижнюю границу нужно включить в возвращаемое представление; toKey — верхняя граница ключей возвращаемой карты; toInclusive — true, если верхнюю границу нужно включить в возвращаемое представление
Возвращает:: представление части этой карты, ключи которой находятся в диапазоне от fromKey до toKey
Выбрасывает:: ClassCastException — если fromKey и toKey нельзя сравнить друг с другом с помощью компаратора этой карты (или, если у карты нет компаратора, с помощью естественного порядка). Реализации могут выбрасывать это исключение, но не обязаны, если fromKey или toKey нельзя сравнить с ключами, находящимися в карте в данный момент.; NullPointerException — если fromKey или toKey равно null, а эта карта не допускает null в качестве ключей; IllegalArgumentException — если fromKey больше toKey; или если диапазон самой карты ограничен, а fromKey или toKey находится за его границами

headMap

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

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

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

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

Указано в:: headMap в интерфейсе NavigableMap<K,V>
Параметры:: toKey — верхняя граница ключей возвращаемой карты; inclusive — true, если верхнюю границу нужно включить в возвращаемое представление
Возвращает:: представление части этой карты, ключи которой меньше toKey (или равны ему, если inclusive равно true)
Выбрасывает:: ClassCastException — если toKey несовместим с компаратором этой карты (или, если у карты нет компаратора, если toKey не реализует Comparable). Реализации могут выбрасывать это исключение, но не обязаны, если toKey нельзя сравнить с ключами, находящимися в карте в данный момент.; NullPointerException — если toKey равно null, а эта карта не допускает null в качестве ключей; IllegalArgumentException — если диапазон самой карты ограничен, а toKey находится за его границами

tailMap

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

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

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

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

Указано в:: tailMap в интерфейсе NavigableMap<K,V>
Параметры:: fromKey — нижняя граница ключей возвращаемой карты; inclusive — true, если нижнюю границу нужно включить в возвращаемое представление
Возвращает:: представление части этой карты, ключи которой больше fromKey (или равны ему, если inclusive равно true)
Выбрасывает:: ClassCastException — если fromKey несовместим с компаратором этой карты (или, если у карты нет компаратора, если fromKey не реализует Comparable). Реализации могут выбрасывать это исключение, но не обязаны, если fromKey нельзя сравнить с ключами, находящимися в карте в данный момент.; NullPointerException — если fromKey равно null, а эта карта не допускает null в качестве ключей; IllegalArgumentException — если диапазон самой карты ограничен, а fromKey находится за его границами

subMap

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

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

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

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

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

Указано в:: subMap в интерфейсе NavigableMap<K,V>
Указано в:: subMap в интерфейсе SortedMap<K,V>
Параметры:: fromKey — нижняя (включительная) граница ключей возвращаемой карты; toKey — верхняя (исключительная) граница ключей возвращаемой карты
Возвращает:: представление части этой карты, ключи которой находятся в диапазоне от fromKey включительно до toKey исключительно
Выбрасывает:: ClassCastException — если fromKey и toKey нельзя сравнить друг с другом с помощью компаратора этой карты (или, если у карты нет компаратора, с помощью естественного порядка). Реализации могут выбрасывать это исключение, но не обязаны, если fromKey или toKey нельзя сравнить с ключами, находящимися в карте в данный момент.; NullPointerException — если fromKey или toKey равно null, а эта карта не допускает null в качестве ключей; IllegalArgumentException — если fromKey больше toKey; или если диапазон самой карты ограничен, а fromKey или toKey находится за его границами

headMap

ConcurrentNavigableMap<K,V> headMap(K toKey)

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

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

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

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

Указано в:: headMap в интерфейсе NavigableMap<K,V>
Указано в:: headMap в интерфейсе SortedMap<K,V>
Параметры:: toKey — верхняя (исключительная) граница ключей возвращаемой карты
Возвращает:: представление части этой карты, ключи которой строго меньше toKey
Выбрасывает:: ClassCastException — если toKey несовместим с компаратором этой карты (или, если у карты нет компаратора, если toKey не реализует Comparable). Реализации могут выбрасывать это исключение, но не обязаны, если toKey нельзя сравнить с ключами, находящимися в карте в данный момент.; NullPointerException — если toKey равно null, а эта карта не допускает null в качестве ключей; IllegalArgumentException — если диапазон самой карты ограничен, а toKey находится за его границами

tailMap

ConcurrentNavigableMap<K,V> tailMap(K fromKey)

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

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

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

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

Указано в:: tailMap в интерфейсе NavigableMap<K,V>
Указано в:: tailMap в интерфейсе SortedMap<K,V>
Параметры:: fromKey — нижняя (включительная) граница ключей возвращаемой карты
Возвращает:: представление части этой карты, ключи которой больше или равны fromKey
Выбрасывает:: ClassCastException — если fromKey несовместим с компаратором этой карты (или, если у карты нет компаратора, если fromKey не реализует Comparable). Реализации могут выбрасывать это исключение, но не обязаны, если fromKey нельзя сравнить с ключами, находящимися в карте в данный момент.; NullPointerException — если fromKey равно null, а эта карта не допускает null в качестве ключей; IllegalArgumentException — если диапазон самой карты ограничен, а fromKey находится за его границами

descendingMap

ConcurrentNavigableMap<K,V> descendingMap()

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

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

Указано в:: descendingMap в интерфейсе NavigableMap<K,V>
Возвращает:: представление этой карты в обратном порядке

navigableKeySet

NavigableSet<K> navigableKeySet()

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

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

Указано в:: navigableKeySet в интерфейсе NavigableMap<K,V>
Возвращает:: представление ключей этой карты в виде навигационного множества

keySet

NavigableSet<K> keySet()

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

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

Указано в:: keySet в интерфейсе Map<K,V>
Указано в:: keySet в интерфейсе SortedMap<K,V>
Возвращает:: представление ключей этой карты в виде навигационного множества

descendingKeySet

NavigableSet<K> descendingKeySet()

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

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

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

© 1993, 2025, 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/25/docs/api/java.base/java/util/concurrent/ConcurrentNavigableMap.html