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, toStringpublic 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>Cloneablepublic boolean containsKey(Object key)
trueを返します。containsKey、インタフェース: Map<K,V>containsKey、クラス: AbstractMap<K,V>key - このマップ内にあるかどうかが判定されるキーtrueClassCastException - 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException - 指定されたキーがnullである場合public V get(Object key)
nullを返します。
つまり、マップの順序付けに従ってkeyがkに等しくなるような、キーkから値vへのマッピングがこのマップに含まれている場合、このメソッドはvを返します。それ以外の場合は、nullを返します。(このようなマッピングは1つのみ存在できます。)
get、インタフェース: Map<K,V>get、クラス: AbstractMap<K,V>key - 関連付けられた値が返されるキーnullClassCastException - 指定されたキーがマップ内に現在あるキーと比較できない場合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。それ以外の場合はfalseNullPointerException - 指定された値が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()
ConcurrentNavigableMapNavigableSetビューを返します。セットのイテレータは、キーを昇順で返します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットは要素の削除をサポートします。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()
ConcurrentNavigableMapNavigableSetビューを返します。セットのイテレータは、キーを降順で返します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットは要素の削除をサポートします。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 - このマップと等しいかどうかが比較されるオブジェクトtrueObject.hashCode()、HashMappublic 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 - 指定されたキーに関連付けられていると予想される値trueClassCastException - 指定されたキーがマップ内に現在あるキーと比較できない場合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 - 指定されたキーに関連付けられる値trueClassCastException - 指定されたキーがマップ内に現在あるキーと比較できない場合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()
SortedMapnullを返します。comparator、インタフェース: SortedMap<K,V>nullpublic K firstKey()
SortedMapfirstKey、インタフェース: SortedMap<K,V>NoSuchElementException - マップが空の場合public K lastKey()
SortedMaplastKey、インタフェース: SortedMap<K,V>NoSuchElementException - マップが空の場合public ConcurrentNavigableMap<K,V> subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive)
NavigableMapfromKey - toKeyのキー範囲を持つ部分のビューを返します。fromKeyとtoKeyが等しい場合、返されるマップは、fromInclusiveとtoInclusiveの両方がtrueでないかぎり、空になります。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
返されるマップは、その範囲外のキーが挿入されようとしたり、端点のいずれかがその範囲外にあるようなサブマップが構築されようとしたりすると、IllegalArgumentExceptionをスローします。
subMap、インタフェース: ConcurrentNavigableMap<K,V>subMap、インタフェース: NavigableMap<K,V>fromKey - 返されるマップ内のキーの下端点fromInclusive - 返されるビューに下端点が含まれる場合はtruetoKey - 返されるマップ内のキーの上端点toInclusive - 返されるビューに上端点が含まれる場合はtruefromKey - toKeyのキー範囲を持つ部分のビューClassCastException - このマップのコンパレータを使用して(このマップがコンパレータを持たない場合は自然順序付けを使用して)、fromKeyとtoKeyを相互に比較できない場合。実装は、マップ内に現在存在しているキーとfromKeyまたはtoKeyとを比較できない場合にこの例外をスローすることができる。ただし、必須ではない。NullPointerException - fromKeyまたはtoKeyがnullである場合IllegalArgumentException - fromKeyがtoKeyよりも大きい場合、またはこのマップ自体が制限された範囲を持っており、fromKeyまたはtoKeyがその範囲から外れている場合public ConcurrentNavigableMap<K,V> headMap(K toKey, boolean inclusive)
NavigableMaptoKeyよりも小さいキー(inclusiveがtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビューを返します。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentExceptionをスローします。
headMap、インタフェース: ConcurrentNavigableMap<K,V>headMap、インタフェース: NavigableMap<K,V>toKey - 返されるマップ内のキーの上端点inclusive - 返されるビューに上端点が含まれる場合はtruetoKeyよりも小さいキー(inclusiveがtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビューClassCastException - toKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、toKeyがComparableを実装していない場合)。実装は、マップ内に現在存在しているキーとtoKeyとを比較できない場合にこの例外をスローすることができる。ただし、必須ではない。NullPointerException - toKeyがnullである場合IllegalArgumentException - このマップ自体が制限された範囲を持っており、toKeyがその範囲から外れている場合public ConcurrentNavigableMap<K,V> tailMap(K fromKey, boolean inclusive)
NavigableMapfromKeyよりも大きいキー(inclusiveがtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビューを返します。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentExceptionをスローします。
tailMap、インタフェース: ConcurrentNavigableMap<K,V>tailMap、インタフェース: NavigableMap<K,V>fromKey - 返されるマップ内のキーの下端点inclusive - 返されるビューに下端点が含まれる場合はtruefromKeyよりも大きいキー(inclusiveがtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビューClassCastException - fromKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、fromKeyがComparableを実装していない場合)。実装は、マップ内に現在存在しているキーとfromKeyとを比較できない場合にこの例外をスローすることができる。ただし、必須ではない。NullPointerException - fromKeyがnullである場合IllegalArgumentException - このマップ自体が制限された範囲を持っており、fromKeyがその範囲から外れている場合public ConcurrentNavigableMap<K,V> subMap(K fromKey, K toKey)
NavigableMapfromKey (これを含む) - 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)
NavigableMaptoKeyよりも確実に小さいキーを持つ部分のビューを返します。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
返されるマップは、その範囲外のキーが挿入されようとすると、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)
NavigableMapfromKey以上のキーを持つ部分のビューを返します。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
返されるマップは、その範囲外のキーが挿入されようとすると、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よりも小さいキーの中で最大のものを持つエントリ。そのようなキーが存在しない場合はnullClassCastException - 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException - 指定されたキーがnullである場合public K lowerKey(K key)
NavigableMapnullを返します。lowerKey、インタフェース: NavigableMap<K,V>key - キーkeyよりも小さいキーの中で最大のもの。そのようなキーが存在しない場合はnullClassCastException - 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException - 指定されたキーがnullである場合public Map.Entry<K,V> floorEntry(K key)
nullを返します。返されるエントリは、Entry.setValueメソッドをサポートしません。floorEntry、インタフェース: NavigableMap<K,V>key - キーkeyと等しいか、それよりも小さいキーの中で最大のものを持つエントリ。そのようなキーが存在しない場合はnullClassCastException - 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException - 指定されたキーがnullである場合public K floorKey(K key)
NavigableMapnullを返します。floorKey、インタフェース: NavigableMap<K,V>key - キーkeyと等しいか、それよりも小さいキーの中で最大のもの。そのようなキーが存在しない場合はnullClassCastException - 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException - 指定されたキーがnullである場合public Map.Entry<K,V> ceilingEntry(K key)
nullを返します。返されるエントリは、Entry.setValueメソッドをサポートしません。ceilingEntry、インタフェース: NavigableMap<K,V>key - キーkeyと等しいか、それよりも大きいキーの中で最小のものを持つエントリ。そのようなキーが存在しない場合はnullClassCastException - 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException - 指定されたキーがnullである場合public K ceilingKey(K key)
NavigableMapnullを返します。ceilingKey、インタフェース: NavigableMap<K,V>key - キーkeyと等しいか、それよりも大きいキーの中で最小のもの。そのようなキーが存在しない場合はnullClassCastException - 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException - 指定されたキーがnullである場合public Map.Entry<K,V> higherEntry(K key)
nullを返します。返されるエントリは、Entry.setValueメソッドをサポートしません。higherEntry、インタフェース: NavigableMap<K,V>key - キーkeyよりも大きいキーの中で最小のものを持つエントリ。そのようなキーが存在しない場合はnullClassCastException - 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException - 指定されたキーがnullである場合public K higherKey(K key)
NavigableMapnullを返します。higherKey、インタフェース: NavigableMap<K,V>key - キーkeyよりも大きいキーの中で最小のもの。そのようなキーが存在しない場合はnullClassCastException - 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException - 指定されたキーがnullである場合public Map.Entry<K,V> firstEntry()
nullを返します。返されるエントリは、Entry.setValueメソッドをサポートしません。firstEntry、インタフェース: NavigableMap<K,V>nullpublic Map.Entry<K,V> lastEntry()
nullを返します。返されるエントリは、Entry.setValueメソッドをサポートしません。lastEntry、インタフェース: NavigableMap<K,V>nullpublic Map.Entry<K,V> pollFirstEntry()
nullを返します。返されるエントリは、Entry.setValueメソッドをサポートしません。pollFirstEntry、インタフェース: NavigableMap<K,V>nullpublic Map.Entry<K,V> pollLastEntry()
nullを返します。返されるエントリは、Entry.setValueメソッドをサポートしません。pollLastEntry、インタフェース: NavigableMap<K,V>nullpublic void forEach(BiConsumer<? super K,? super V> action)
ConcurrentMappublic void replaceAll(BiFunction<? super K,? super V,? extends V> function)
ConcurrentMapreplaceAll、インタフェース: ConcurrentMap<K,V>replaceAll、インタフェース: Map<K,V>function - 各エントリに適用する関数 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.