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

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

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

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

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

A ConcurrentMap поддерживающий операции NavigableMap, и рекурсивно для её подкарт navigable.

Этот интерфейс является членом Java Collections Framework.

С тех пор:: 1.6

Вложенные классы

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

Map.Entry<K,V>

Методы

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

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

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

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

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

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

comparator, entrySet, firstKey, lastKey, values

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

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

Методы

subMap

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

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

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

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

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

headMap

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

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

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

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

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

tailMap

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

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

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

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

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

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

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

Этот метод эквивалентен методу 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, 2020, 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.