K
- このマップで保持されるキーの型V
- マップされる値の型public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V> implements ConcurrentNavigableMap<K,V>, Cloneable, Serializable
ConcurrentNavigableMap
実装です。マップは、使用するコンストラクタに応じて、そのキーの自然順序付けに従って、またはマップ作成時に提供されるComparator
によってソートされます。
このクラスは、SkipListsの並行バリアントを実装して、containsKey、get
、put
、およびremove
オペレーションとそれらのバリアントに予想される平均log(n)
時間コストを提供します。挿入、削除、更新、アクセスの各オペレーションは、複数のスレッドによって並行して、安全に実行されます。
イテレータおよびスプリッテレータは弱一貫性を持っています。
昇順のキーで並べられたビューとそのイテレータは、降順の場合よりも高速になります。
このクラス内のメソッドによって返されるすべてのMap.Entry
ペアとそのビューは、マッピングが生成された時点のそのスナップショットを表します。これらはEntry.setValueメソッドをサポートしていません
。ただし、必要とする効果に応じて、put
、putIfAbsent
、またはreplace
を使用して、関連付けられたマップ内のマッピングを変更できることに注意してください。
大半のコレクションとは異なり、size
メソッドは一定時間のオペレーションではないことに留意してください。これらのマップには非同期という特性があるため、現在の要素数を判定するには要素のトラバーサルが必要になります。そのため、このコレクションがトラバーサル中に変更された場合は、不正確な結果が報告される可能性があります。さらに、putAll
、equals
、toArray
、containsValue
およびclear
の一括オペレーションが原子的に実行されるという保証はありません。たとえば、putAll
オペレーションと並行して動作しているイテレータは、追加された要素の一部しか表示しないことがあります。
このクラスとそのビューおよびイテレータは、Map
およびIterator
インタフェースのオプションメソッドすべてを実装します。他のほとんどの並行処理コレクションと同様、このクラスはnull
のキーまたは値の使用を許可しません。これは、一部のnullの戻り値は要素がない場合と確実に区別できないためです。
このクラスは、Java Collections Frameworkのメンバーです。
AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>
コンストラクタと説明 |
---|
ConcurrentSkipListMap()
キーの自然順序付けに従ってソートされた、新しい空のマップを作成します。
|
ConcurrentSkipListMap(Comparator<? super K> comparator)
指定されたコンパレータに従ってソートされた、新しい空のマップを作成します。
|
ConcurrentSkipListMap(Map<? extends K,? extends V> m)
指定されたマップと同じマッピングを持ち、キーの自然順序付けに従ってソートされた新しいマップを作成します。
|
ConcurrentSkipListMap(SortedMap<K,? extends V> m)
指定されたソート・マップと同じマッピングを持ち、同じ順序付けを使用する、新しいマップを作成します。
|
修飾子と型 | メソッドと説明 |
---|---|
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)
マップが1つまたは複数のキーを指定された値にマッピングしている場合に
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 を返します。 |
void |
forEach(BiConsumer<? super K,? super V> action)
このマップのすべてのエントリの処理が完了するかアクションから例外がスローされるまで、各エントリに対して指定されたアクションを実行します。
|
V |
get(Object key)
指定されたキーがマップされている値を返します。このマップにそのキーのマッピングが含まれていない場合は
null を返します。 |
V |
getOrDefault(Object key, V defaultValue)
指定されたキーがマップされる値を返します。このマップにそのキーのマッピングが含まれていない場合は、指定されたdefaultValueを返します。
|
ConcurrentNavigableMap<K,V> |
headMap(K toKey)
このマップの
toKey よりも確実に小さいキーを持つ部分のビューを返します。 |
ConcurrentNavigableMap<K,V> |
headMap(K toKey, boolean inclusive)
このマップの
toKey よりも小さいキー(inclusive がtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビューを返します。 |
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)
指定された値にキーが現在マッピングされている場合にのみ、そのキーのエントリを置換します。
|
void |
replaceAll(BiFunction<? super K,? super V,? extends V> function)
すべてのエントリが処理されるか、または関数が例外をスローするまで、各エントリの値を、そのエントリで指定された関数を呼び出した結果で置換します。
|
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)
このマップの
fromKey よりも大きいキー(inclusive がtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビューを返します。 |
Collection<V> |
values()
このマップに含まれる値の
Collection ビューを返します。 |
hashCode, putAll, toString
public ConcurrentSkipListMap()
public ConcurrentSkipListMap(Comparator<? super K> comparator)
comparator
- このマップの順序付けを行うために使用されるコンパレータ。null
の場合は、キーの自然順序付けが使用される。public ConcurrentSkipListMap(Map<? extends K,? extends V> m)
m
- マッピングがこのマップに配置されるマップClassCastException
- m
内のキーがComparable
でないか、または相互に比較可能でない場合NullPointerException
- 指定されたマップ、またはそのキーと値のいずれかがnullの場合public ConcurrentSkipListMap(SortedMap<K,? extends V> m)
m
- マッピングがこのマップに配置され、コンパレータがこのマップのソートに使用される、ソートされたマップNullPointerException
- 指定されたソートされたマップ、またはそのキーと値のいずれかがnullの場合public ConcurrentSkipListMap<K,V> clone()
ConcurrentSkipListMap
のインスタンスのシャロー・コピーを返します。そのキーと値は複製されません。clone
、クラス: AbstractMap<K,V>
Cloneable
public boolean containsKey(Object key)
true
を返します。containsKey
、インタフェース: Map<K,V>
containsKey
、クラス: AbstractMap<K,V>
key
- このマップ内にあるかどうかが判定されるキーtrue
ClassCastException
- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException
- 指定されたキーがnullである場合public V get(Object key)
null
を返します。
つまり、マップの順序付けに従ってkey
がk
に等しくなるような、キーk
から値v
へのマッピングがこのマップに含まれている場合、このメソッドはv
を返します。それ以外の場合は、null
を返します。(このようなマッピングは1つのみ存在できます。)
get
、インタフェース: Map<K,V>
get
、クラス: AbstractMap<K,V>
key
- 関連付けられた値が返されるキーnull
ClassCastException
- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException
- 指定されたキーがnullである場合public V getOrDefault(Object key, V defaultValue)
getOrDefault
、インタフェース: ConcurrentMap<K,V>
getOrDefault
、インタフェース: Map<K,V>
key
- キーdefaultValue
- このマップに指定されたキーのマッピングが含まれていない場合に返す値NullPointerException
- 指定されたキーがnullである場合public V put(K key, V value)
put
、インタフェース: Map<K,V>
put
、クラス: AbstractMap<K,V>
key
- 指定された値が関連付けられるキーvalue
- 指定されたキーに関連付けられる値null
。ClassCastException
- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException
- 指定されたキーまたは値がnullの場合public V remove(Object key)
remove
、インタフェース: Map<K,V>
remove
、クラス: AbstractMap<K,V>
key
- マッピングを削除する必要があるキーnull
。ClassCastException
- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException
- 指定されたキーがnullである場合public boolean containsValue(Object value)
true
を返します。このオペレーションはマップのサイズに正比例した時間がかかります。さらに、このメソッドの実行中にマップが変更される可能性があり、その場合は返される結果が不正確になることがあります。containsValue
、インタフェース: Map<K,V>
containsValue
、クラス: AbstractMap<K,V>
value
- このマップにあるかどうかが判定される値value
へのマッピングが存在する場合はtrue
。それ以外の場合はfalse
NullPointerException
- 指定された値がnullである場合public int size()
Integer.MAX_VALUE
を超える要素が含まれている場合は、Integer.MAX_VALUE
を返します。
大半のコレクションとは異なり、このメソッドは一定時間のオペレーションではないことに留意してください。これらのマップには非同期という特性があるため、現在の要素数を判定するには要素すべてをトラバースしてカウントする必要があります。また、このメソッドの実行中にサイズが変更される可能性もあり、その場合、返される値は不正確になります。そのため、このメソッドは、通常は並行処理アプリケーションではあまり便利ではありません。
public boolean isEmpty()
true
を返します。public void clear()
public V computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction)
null
でない場合はそれをこのマップに入力します。値が存在しない場合にのみこの関数が原子的に1回適用されるという保証はありません。computeIfAbsent
、インタフェース: ConcurrentMap<K,V>
computeIfAbsent
、インタフェース: Map<K,V>
key
- 指定された値が関連付けられるキーmappingFunction
- 値を計算するための関数NullPointerException
- 指定されたキーがnullであるか、またはmappingFunctionがnullである場合public V computeIfPresent(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)
computeIfPresent
、インタフェース: ConcurrentMap<K,V>
computeIfPresent
、インタフェース: Map<K,V>
key
- 値を関連付けることができるキーremappingFunction
- 値を計算するための関数NullPointerException
- 指定されたキーがnullであるか、またはremappingFunctionがnullである場合public V compute(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)
null
)。この関数が原子的に1回適用されるという保証はありません。compute
、インタフェース: ConcurrentMap<K,V>
compute
、インタフェース: Map<K,V>
key
- 指定された値が関連付けられるキーremappingFunction
- 値を計算するための関数NullPointerException
- 指定されたキーがnullであるか、またはremappingFunctionがnullである場合public V merge(K key, V value, BiFunction<? super V,? super V,? extends V> remappingFunction)
null
の場合は削除します。この関数が原子的に1回適用されるという保証はありません。merge
、インタフェース: ConcurrentMap<K,V>
merge
、インタフェース: Map<K,V>
key
- 指定された値が関連付けられるキーvalue
- 値が存在しない場合に使用する値remappingFunction
- 値が存在する場合に値を再計算するための関数NullPointerException
- 指定されたキーまたは値がnullであるか、あるいはremappingFunctionがnullである場合public NavigableSet<K> keySet()
NavigableSet
ビューを返します。
セットのイテレータは、キーを昇順で返します。セットのスプリッテレータはさらに、Spliterator.CONCURRENT
、Spliterator.NONNULL
、Spliterator.SORTED
およびSpliterator.ORDERED
(キーの昇順である検出順序で)を報告します。マップのコンパレータ(comparator()
を参照)がnull
である場合、スプリッテレータのコンパレータ(Spliterator.getComparator()
を参照)はnull
です。それ以外の場合、スプリッテレータのコンパレータはマップのコンパレータと同じであるか、同じ全体順序付けを義務付けます。
セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットは要素の削除をサポートします。Iterator.remove
、Set.remove
、removeAll
、retainAll
、およびclear
オペレーションで対応するマッピングをマップから削除します。add
またはaddAll
オペレーションはサポートされていません。
ビューのイテレータおよびスプリッテレータは、弱一貫性を持っています。
このメソッドは、メソッドnavigableKeySet
と同等です。
public NavigableSet<K> navigableKeySet()
ConcurrentNavigableMap
NavigableSet
ビューを返します。セットのイテレータは、キーを昇順で返します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットは要素の削除をサポートします。Iterator.remove
、Set.remove
、removeAll
、retainAll
、およびclear
オペレーションで対応するマッピングをマップから削除します。add
またはaddAll
オペレーションはサポートされていません。
ビューのイテレータおよびスプリッテレータは、弱一貫性を持っています。
navigableKeySet
、インタフェース: ConcurrentNavigableMap<K,V>
navigableKeySet
、インタフェース: NavigableMap<K,V>
public Collection<V> values()
Collection
ビューを返します。
コレクションのイテレータは、値を対応するキーの昇順で返します。コレクションのスプリッテレータはさらに、Spliterator.CONCURRENT
、Spliterator.NONNULL
およびSpliterator.ORDERED
(キーの昇順である検出順序で)を報告します。
コレクションはマップと連動しているので、マップに対する変更はコレクションに反映され、またコレクションに対する変更はマップに反映されます。コレクションは要素の削除をサポートしており、対応するマッピングをマップから削除できます。削除は、Iterator.remove
、Collection.remove
、removeAll
、retainAll
、およびclear
オペレーションを通して行います。add
またはaddAll
オペレーションはサポートされていません。
ビューのイテレータおよびスプリッテレータは、弱一貫性を持っています。
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
オペレーションはサポートされていません。
ビューのイテレータおよびスプリッテレータは、弱一貫性を持っています。
iterator
またはspliterator
によってトラバースされるMap.Entry
の要素は、setValue
オペレーションをサポートしません。
public ConcurrentNavigableMap<K,V> descendingMap()
ConcurrentNavigableMap
返されるマップの順序付けは、Collections.reverseOrder
(comparator())
と同等になります。式m.descendingMap().descendingMap()
から返されるm
のビューは基本的にm
と同等になります。
descendingMap
、インタフェース: ConcurrentNavigableMap<K,V>
descendingMap
、インタフェース: NavigableMap<K,V>
public NavigableSet<K> descendingKeySet()
ConcurrentNavigableMap
NavigableSet
ビューを返します。セットのイテレータは、キーを降順で返します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットは要素の削除をサポートします。Iterator.remove
、Set.remove
、removeAll
、retainAll
、およびclear
オペレーションで対応するマッピングをマップから削除します。add
またはaddAll
オペレーションはサポートされていません。
ビューのイテレータおよびスプリッテレータは、弱一貫性を持っています。
descendingKeySet
、インタフェース: ConcurrentNavigableMap<K,V>
descendingKeySet
、インタフェース: NavigableMap<K,V>
public boolean equals(Object o)
true
を返します。つまり、m1.entrySet().equals(m2.entrySet())
である場合、2つのマップm1
とm2
は同じマッピングを表します。このオペレーションは、マップのいずれかがこのメソッドの実行中に並行して変更された場合、誤解を招きやすい結果を返すことがあります。equals
、インタフェース: Map<K,V>
equals
、クラス: AbstractMap<K,V>
o
- このマップと等しいかどうかが比較されるオブジェクトtrue
Object.hashCode()
、HashMap
public V putIfAbsent(K key, V value)
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の場合public boolean remove(Object key, Object value)
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である場合public boolean replace(K key, V oldValue, V newValue)
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
- 引数が1つでもnullの場合public V replace(K key, V value)
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の場合public Comparator<? super K> comparator()
SortedMap
null
を返します。comparator
、インタフェース: SortedMap<K,V>
null
public K firstKey()
SortedMap
firstKey
、インタフェース: SortedMap<K,V>
NoSuchElementException
- マップが空の場合public K lastKey()
SortedMap
lastKey
、インタフェース: SortedMap<K,V>
NoSuchElementException
- マップが空の場合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
がその範囲から外れている場合public ConcurrentNavigableMap<K,V> headMap(K toKey, boolean inclusive)
NavigableMap
toKey
よりも小さいキー(inclusive
がtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビューを返します。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentException
をスローします。
headMap
、インタフェース: ConcurrentNavigableMap<K,V>
headMap
、インタフェース: NavigableMap<K,V>
toKey
- 返されるマップ内のキーの上端点inclusive
- 返されるビューに上端点が含まれる場合はtrue
toKey
よりも小さいキー(inclusive
がtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビューClassCastException
- toKey
がこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、toKey
がComparable
を実装していない場合)。実装は、マップ内に現在存在しているキーとtoKey
とを比較できない場合にこの例外をスローすることができる。ただし、必須ではない。NullPointerException
- toKey
がnullである場合IllegalArgumentException
- このマップ自体が制限された範囲を持っており、toKey
がその範囲から外れている場合public ConcurrentNavigableMap<K,V> tailMap(K fromKey, boolean inclusive)
NavigableMap
fromKey
よりも大きいキー(inclusive
がtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビューを返します。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentException
をスローします。
tailMap
、インタフェース: ConcurrentNavigableMap<K,V>
tailMap
、インタフェース: NavigableMap<K,V>
fromKey
- 返されるマップ内のキーの下端点inclusive
- 返されるビューに下端点が含まれる場合はtrue
fromKey
よりも大きいキー(inclusive
がtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビューClassCastException
- fromKey
がこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、fromKey
がComparable
を実装していない場合)。実装は、マップ内に現在存在しているキーとfromKey
とを比較できない場合にこの例外をスローすることができる。ただし、必須ではない。NullPointerException
- fromKey
がnullである場合IllegalArgumentException
- このマップ自体が制限された範囲を持っており、fromKey
がその範囲から外れている場合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
がその範囲から外れている場合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
がその範囲から外れている場合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
がその範囲から外れている場合public Map.Entry<K,V> lowerEntry(K key)
null
を返します。返されるエントリは、Entry.setValue
メソッドをサポートしません。lowerEntry
、インタフェース: NavigableMap<K,V>
key
- キーkey
よりも小さいキーの中で最大のものを持つエントリ。そのようなキーが存在しない場合はnull
ClassCastException
- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException
- 指定されたキーがnullである場合public K lowerKey(K key)
NavigableMap
null
を返します。lowerKey
、インタフェース: NavigableMap<K,V>
key
- キーkey
よりも小さいキーの中で最大のもの。そのようなキーが存在しない場合はnull
ClassCastException
- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException
- 指定されたキーがnullである場合public Map.Entry<K,V> floorEntry(K key)
null
を返します。返されるエントリは、Entry.setValue
メソッドをサポートしません。floorEntry
、インタフェース: NavigableMap<K,V>
key
- キーkey
と等しいか、それよりも小さいキーの中で最大のものを持つエントリ。そのようなキーが存在しない場合はnull
ClassCastException
- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException
- 指定されたキーがnullである場合public K floorKey(K key)
NavigableMap
null
を返します。floorKey
、インタフェース: NavigableMap<K,V>
key
- キーkey
と等しいか、それよりも小さいキーの中で最大のもの。そのようなキーが存在しない場合はnull
ClassCastException
- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException
- 指定されたキーがnullである場合public Map.Entry<K,V> ceilingEntry(K key)
null
を返します。返されるエントリは、Entry.setValue
メソッドをサポートしません。ceilingEntry
、インタフェース: NavigableMap<K,V>
key
- キーkey
と等しいか、それよりも大きいキーの中で最小のものを持つエントリ。そのようなキーが存在しない場合はnull
ClassCastException
- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException
- 指定されたキーがnullである場合public K ceilingKey(K key)
NavigableMap
null
を返します。ceilingKey
、インタフェース: NavigableMap<K,V>
key
- キーkey
と等しいか、それよりも大きいキーの中で最小のもの。そのようなキーが存在しない場合はnull
ClassCastException
- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException
- 指定されたキーがnullである場合public Map.Entry<K,V> higherEntry(K key)
null
を返します。返されるエントリは、Entry.setValue
メソッドをサポートしません。higherEntry
、インタフェース: NavigableMap<K,V>
key
- キーkey
よりも大きいキーの中で最小のものを持つエントリ。そのようなキーが存在しない場合はnull
ClassCastException
- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException
- 指定されたキーがnullである場合public K higherKey(K key)
NavigableMap
null
を返します。higherKey
、インタフェース: NavigableMap<K,V>
key
- キーkey
よりも大きいキーの中で最小のもの。そのようなキーが存在しない場合はnull
ClassCastException
- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException
- 指定されたキーがnullである場合public Map.Entry<K,V> firstEntry()
null
を返します。返されるエントリは、Entry.setValue
メソッドをサポートしません。firstEntry
、インタフェース: NavigableMap<K,V>
null
public Map.Entry<K,V> lastEntry()
null
を返します。返されるエントリは、Entry.setValue
メソッドをサポートしません。lastEntry
、インタフェース: NavigableMap<K,V>
null
public Map.Entry<K,V> pollFirstEntry()
null
を返します。返されるエントリは、Entry.setValue
メソッドをサポートしません。pollFirstEntry
、インタフェース: NavigableMap<K,V>
null
public Map.Entry<K,V> pollLastEntry()
null
を返します。返されるエントリは、Entry.setValue
メソッドをサポートしません。pollLastEntry
、インタフェース: NavigableMap<K,V>
null
public void forEach(BiConsumer<? super K,? super V> action)
ConcurrentMap
public void replaceAll(BiFunction<? super K,? super V,? extends V> function)
ConcurrentMap
replaceAll
、インタフェース: ConcurrentMap<K,V>
replaceAll
、インタフェース: Map<K,V>
function
- 各エントリに適用する関数 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.