ConcurrentSkipListMap

ConcurrentSkipListMap

ConcurrentSkipListMap ()

构造一个新的空地图，按照键的 natural ordering排序。

ConcurrentSkipListMap

ConcurrentSkipListMap (Comparator<? super K> comparator)

构造一个新的空映射，按照指定的比较器进行排序。

ConcurrentSkipListMap

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

构造一个包含与给定映射相同映射的新映射，并根据键的 natural ordering进行排序。

ConcurrentSkipListMap

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

构造一个包含相同映射的新映射，并使用与指定的有序映射相同的顺序。

ceilingEntry

Entry<K, V> ceilingEntry (K key)

返回与最小键大于或等于给定键相关联的键 - 值映射，如果不存在这样的条目，则null 。 返回的条目不支持Entry.setValue方法。

ceilingKey

K ceilingKey (K key)

返回大于或等于给定键的 null键，或者如果不存在这样的键，则 null 。

clear

void clear ()

从此映射中移除所有映射。

clone

ConcurrentSkipListMap<K, V> clone ()

返回此ConcurrentSkipListMap实例的浅表副本。 （键和值本身不克隆。）

comparator

Comparator<? super K> comparator ()

返回用于为了在这个映射中的键，或比较 null如果此映射使用 natural ordering它的键。

compute

V compute (K key, 
                BiFunction<? super K, ? super V, ? extends V> remappingFunction)

尝试计算指定键和其当前映射值的映射（如果没有当前映射， null ）。 该功能不保证以原子方式应用一次。

computeIfAbsent

V computeIfAbsent (K key, 
                Function<? super K, ? extends V> mappingFunction)

如果指定的键尚未与值相关联，则尝试使用给定的映射函数计算其值，并将其输入到此映射中，除非null 。 该功能不保证只有当该值不存在时才以原子方式应用一次。

computeIfPresent

V computeIfPresent (K key, 
                BiFunction<? super K, ? super V, ? extends V> remappingFunction)

如果指定键的值存在，则尝试计算给定键和其当前映射值的新映射。 该功能不保证以原子方式应用一次。

containsKey

boolean containsKey (Object key)

如果此映射包含指定键的映射，则返回 true 。

containsValue

boolean containsValue (Object value)

如果此映射将一个或多个键映射到指定值，则返回true 。 此操作需要地图大小的时间线性。 此外，在执行此方法时可能会更改地图，在这种情况下返回的结果可能不准确。

descendingKeySet

NavigableSet<K> descendingKeySet ()

返回包含在此映射中的键的相反顺序NavigableSet视图。 集合的迭代器按降序返回键。 该集合由地图支持，因此对地图的更改反映在集合中，反之亦然。 该组支持元件移除，即从映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll ，和clear操作。 它不支持add或addAll操作。

视图的迭代器和分割器是 weakly consistent 。

descendingMap

ConcurrentNavigableMap<K, V> descendingMap ()

返回此映射中包含的映射的逆序视图。 降序地图由此地图支持，因此对地图的更改反映在降序地图中，反之亦然。

返回的地图的订购等同于Collections.reverseOrder (comparator()) 。 表达m.descendingMap().descendingMap()返回一个视图的m实质上等同于m 。

entrySet

Set<Entry<K, V>> entrySet ()

返回此映射中映射的映射的 Set视图。

该集的迭代器按照升序键顺序返回条目。 该集的spliterator另外报告CONCURRENT ， NONNULL ， SORTED和ORDERED ，与被按键的升序的顺序相遇。

该集合由地图支持，因此对地图的更改反映在集合中，反之亦然。 该组支持元件移除，即从映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll和clear操作。 它不支持add或addAll操作。

视图的迭代器和分割器是 weakly consistent 。

iterator或 spliterator遍历的 Map.Entry元素 不支持 setValue操作。

equals

boolean equals (Object o)

将指定的对象与此映射进行比较以获得相等性。 如果给定的对象也是一个映射，并且这两个映射表示相同的映射，则返回true 。 更正式地说，两个映射m1和m2表示如果m1.entrySet().equals(m2.entrySet())相同的映射。 如果在执行此方法期间同时修改其中一个映射，此操作可能会返回误导结果。

firstEntry

Entry<K, V> firstEntry ()

返回与此地图中最小键相关的键值映射，如果地图为空，则null 。 返回的条目不支持Entry.setValue方法。

firstKey

K firstKey ()

返回此地图中当前第一个（最低）的键。

floorEntry

Entry<K, V> floorEntry (K key)

返回与最大键小于或等于给定键相关联的键值映射，或者如果不存在这样的键，则null 。 返回的条目不支持Entry.setValue方法。

floorKey

K floorKey (K key)

返回小于或等于给定键的最大键，或者如果不存在这样的键，则 null 。

forEach

void forEach (BiConsumer<? super K, ? super V> action)

对此映射中的每个条目执行给定操作，直到处理完所有条目或操作抛出异常为止。 除非实现类另有规定，否则按照条目集迭代的顺序执行操作（如果指定了迭代顺序）。操作抛出的异常会中继给调用者。

get

V get (Object key)

返回指定键映射到的值，如果此映射不包含键映射，则返回 null 。

更正式地，如果此映射包含从密钥映射k到值v使得key比较等于k根据地图的排序，则此方法返回v ; 否则返回null 。 （最多可以有一个这样的映射。）

getOrDefault

V getOrDefault (Object key, 
                V defaultValue)

返回指定键映射到的值;如果此映射不包含键映射，则返回给定的defaultValue。

headMap

ConcurrentNavigableMap<K, V> headMap (K toKey)

返回此映射的关键字严格小于toKey的部分的视图。 返回的地图由此地图支持，因此返回地图中的更改会反映在此地图中，反之亦然。 返回的地图支持该地图支持的所有可选地图操作。

尝试在其范围外插入密钥时，返回的地图会抛出 IllegalArgumentException 。

相当于 headMap(toKey, false) 。

headMap

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

返回此映射关键字小于（或等于，如果inclusive为true）的部分的toKey 。 返回的地图由此地图支持，因此返回地图中的更改会反映在此地图中，反之亦然。 返回的地图支持该地图支持的所有可选地图操作。

试图在其范围外插入密钥时，返回的地图会抛出 IllegalArgumentException 。

higherEntry

Entry<K, V> higherEntry (K key)

返回与最小键相关的键值映射，严格大于给定键，或者如果没有这样的键，则null 。 返回的条目不支持Entry.setValue方法。

higherKey

K higherKey (K key)

如果不存在这样的密钥，则返回严格大于给定密钥的最小密钥或 null 。

isEmpty

boolean isEmpty ()

如果此映射不包含键 - 值映射，则返回 true 。

keySet

NavigableSet<K> keySet ()

返回此映射中包含的键的 NavigableSet视图。

集合的迭代器按照升序返回键。 该集的spliterator另外报告CONCURRENT ， NONNULL ， SORTED和ORDERED ，与被按键的升序的顺序相遇。 该spliterator的比较（见getComparator() ）是null如果映射的比较（见comparator() ）是null 。 否则，分割器的比较器与地图比较器相同，或者施加相同的总排序。

该集合由地图支持，因此对地图的更改反映在集合中，反之亦然。 该组支持元件移除，即从映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll ，和clear操作。 它不支持add或addAll操作。

视图的迭代器和分割器是 weakly consistent 。

该方法相当于方法 navigableKeySet 。

lastEntry

Entry<K, V> lastEntry ()

返回与此地图中最大键相关的键值映射，如果地图为空，则null 。 返回的条目不支持Entry.setValue方法。

lastKey

K lastKey ()

返回此地图中当前最后一个（最高）的键。

lowerEntry

Entry<K, V> lowerEntry (K key)

返回与最大键相关的键 - 值映射严格小于给定键，或者如果不存在这样的键，则null 。 返回的条目不支持Entry.setValue方法。

lowerKey

K lowerKey (K key)

如果没有这样的密钥，则返回严格小于给定密钥的最大密钥，或 null 。

merge

V merge (K key, 
                V value, 
                BiFunction<? super V, ? super V, ? extends V> remappingFunction)

如果指定的键尚未与值相关联，则将其与给定值相关联。 否则，将该值替换为给定的重映射函数的结果，或者如果null移除。 该功能不保证以原子方式应用一次。

navigableKeySet

NavigableSet<K> navigableKeySet ()

返回此映射中包含的键的NavigableSet视图。 集合的迭代器按照升序返回键。 该集合由地图支持，因此对地图的更改反映在集合中，反之亦然。 该组支持元件移除，即从映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll ，和clear操作。 它不支持add或addAll操作。

视图的迭代器和分割器是 weakly consistent 。

pollFirstEntry

Entry<K, V> pollFirstEntry ()

删除并返回与此地图中最小键值关联的键值映射，如果地图为空，则null 。 返回的条目不支持Entry.setValue方法。

pollLastEntry

Entry<K, V> pollLastEntry ()

移除并返回与此地图中最大关键字关联的键值映射，如果地图为空，则null 。 返回的条目不支持Entry.setValue方法。

put

V put (K key, 
                V value)

将指定的值与此映射中指定的键关联。 如果地图先前包含密钥的映射，则旧值将被替换。

putIfAbsent

V putIfAbsent (K key, 
                V value)

如果指定的键尚未与值相关联，则将其与给定值相关联。 这相当于这个map ：

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

remove

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

V remove (Object key)

如果存在，则从该映射中删除指定键的映射。

replace

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

V replace (K key, 
                V value)

仅当当前映射到某个值时才替换密钥的条目。 这相当于这个map ：

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

replaceAll

void replaceAll (BiFunction<? super K, ? super V, ? extends V> function)

用对该条目调用给定函数的结果替换每个条目的值，直到处理完所有条目或者该函数抛出异常。 函数抛出的异常会传递给调用者。

size

int size ()

返回此映射中键 - 值映射的数量。 如果此地图包含多个Integer.MAX_VALUE元素，则返回Integer.MAX_VALUE 。

请注意，与大多数集合不同，此方法不是一个常量操作。 由于这些映射的异步性质，确定当前元素的数量需要遍历它们来对它们进行计数。 此外，在执行此方法期间可能会更改大小，在这种情况下返回的结果将不准确。 因此，这种方法在并发应用程序中通常不是很有用。

subMap

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

返回此映射部分的视图，其键的范围从fromKey （含）到toKey （独占）。 （如果fromKey和toKey相等，则返回的地图为空。）返回的地图由此地图支持，因此返回的地图中的更改会反映在此地图中，反之亦然。 返回的地图支持该地图支持的所有可选地图操作。

尝试在其范围外插入密钥时，返回的地图会抛出 IllegalArgumentException 。

相当于 subMap(fromKey, true, toKey, false) 。

subMap

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

返回此映射部分的视图，其键的范围从fromKey到toKey 。 如果fromKey和toKey相等，则返回的映射是空的，除非fromInclusive和toInclusive均为真。 返回的地图由此地图支持，因此返回地图中的更改会反映在此地图中，反之亦然。 返回的地图支持该地图支持的所有可选地图操作。

返回的映射将尝试在其范围外插入一个键，或者构造其端点位于其范围之外的子映射 IllegalArgumentException 。

tailMap

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

返回此映射的关键字大于（或等于，如果inclusive为true） fromKey 。 返回的地图由此地图支持，因此返回地图中的更改会反映在此地图中，反之亦然。 返回的地图支持该地图支持的所有可选地图操作。

试图在其范围外插入密钥时，返回的地图会抛出 IllegalArgumentException 。

tailMap

ConcurrentNavigableMap<K, V> tailMap (K fromKey)

返回此映射的关键字大于或等于fromKey的部分的视图。 返回的地图由此地图支持，因此返回地图中的更改会反映在此地图中，反之亦然。 返回的地图支持该地图支持的所有可选地图操作。

尝试在其范围外插入密钥时，返回的地图会抛出 IllegalArgumentException 。

相当于 tailMap(fromKey, true) 。

values

Collection<V> values ()

返回此映射中包含的值的 Collection视图。

集合的迭代器按相应键的升序返回值。 藏品的spliterator另外报告CONCURRENT ， NONNULL和ORDERED ，与正在提升相应的按键顺序的遭遇订单。

该集合由地图支持，因此地图的更改会反映在集合中，反之亦然。 该collection支持元素移除，即从映射中相应的映射，经由Iterator.remove ， Collection.remove ， removeAll ， retainAll和clear操作。 它不支持add或addAll操作。

视图的迭代器和分割器是 weakly consistent 。