Spec-Zone.ru › OpenJDK 21

Интерфейс 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>
A ConcurrentMap поддерживающий операции NavigableMap, и рекурсивно так для его под-карт.

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

С тех пор:
1.6

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

Вложенные классы/интерфейсы, объявленные в интерфейсе java.util.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)
Возвращает представление части этой карты, ключи которой меньше (или равны, если inclusive истинно) 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 истинно) fromKey.

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

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

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

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

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

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

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

sequencedEntrySet, sequencedKeySet, sequencedValues

Методы, объявленные в интерфейсе java.util.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 оба истинны. Возвращаемое отображение основано на этом отображении, поэтому изменения в возвращаемом отображении отражаются в этом отображении, и наоборот. Возвращаемое отображение поддерживает все необязательные операции отображения, которые поддерживает это отображение.

Возвращаемое отображение будет выбрасывать 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, 2023, 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/21/docs/api/java.base/java/util/concurrent/ConcurrentNavigableMap.html

Spec-Zone.ru

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