- 型パラメータ:
K- このマップで保持されるキーの型V- マップされる値の型
- すべての実装されたインタフェース:
Serializable,Cloneable,ConcurrentMap<K,,V> ConcurrentNavigableMap<K,,V> Map<K,,V> NavigableMap<K,,V> SequencedMap<K,,V> SortedMap<K,V>
ConcurrentNavigableMap実装です。 マップは、使用するコンストラクタに応じて、そのキーの自然順序付けに従って、またはマップ作成時に提供されるComparatorによってソートされます。
このクラスは、SkipListsの並行バリアントを実装して、containsKey、get、put、およびremoveオペレーションとそれらのバリアントに予想される平均log(n)時間コストを提供します。 挿入、削除、更新、アクセスの各オペレーションは、複数のスレッドによって並行して、安全に実行されます。
イテレータおよびスプリッテレータは弱一貫性を持っています。
昇順のキーで並べられたビューとそのイテレータは、降順の場合よりも高速になります。
このクラス内のメソッドによって返されるすべてのMap.Entryペアとそのビューは、マッピングの生成時のスナップショットを表します。 これらはEntry.setValueメソッドをサポートしていません。 ただし、必要とする効果に応じて、put、putIfAbsent、またはreplaceを使用して、関連付けられたマップ内のマッピングを変更できることに注意してください。
一括操作putAll, equals, toArray, containsValueおよびclearが原子的に実行されることは保証されないことに注意してください。 たとえば、putAllオペレーションと並行して動作しているイテレータは、追加された要素の一部しか表示しないことがあります。
このクラスとそのビューおよびイテレータは、MapおよびIteratorインタフェースのオプション・メソッドすべてを実装します。 他のほとんどの並行処理コレクションと同様、このクラスはnullのキーまたは値の使用を許可しません。これは、一部のnullの戻り値は要素がない場合と確実に区別できないためです。
このクラスは、Java Collections Frameworkのメンバーです。
- 導入されたバージョン:
- 1.6
- 関連項目:
-
ネストされたクラスのサマリー
クラスjava.util.AbstractMapで宣言されたネストされたクラス/インタフェース
AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K, V> -
コンストラクタのサマリー
コンストラクタコンストラクタ説明キーの自然順序付けに従ってソートされた、新しい空のマップを作成します。ConcurrentSkipListMap(Comparator<? super K> comparator) 指定されたコンパレータに従ってソートされた、新しい空のマップを作成します。ConcurrentSkipListMap(Map<? extends K, ? extends V> m) 指定されたマップと同じマッピングを持ち、キーの自然順序付けに従ってソートされた新しいマップを構築します。ConcurrentSkipListMap(SortedMap<K, ? extends V> m) 指定されたソート・マップと同じマッピングを持ち、同じ順序付けを使用する、新しいマップを構築します。 -
メソッドのサマリー
修飾子と型メソッド説明ceilingEntry(K key) 指定されたキー以上の、最小のキーと関連するキーと値のマッピングを返します。そのようなエントリが存在しない場合は、nullを返します。ceilingKey(K key) 指定されたキーと等しいかそれよりも大きいキーの中で最小のものを返します。そのようなキーが存在しない場合はnullを返します。voidclear()すべてのマッピングをマップから削除します。clone()ConcurrentSkipListMapのインスタンスのシャロー・コピーを返します。Comparator<? super K> このマップ内のキーを順序付けするのに使うコンパレータを返します。ただし、このマップがそのキーの自然順序付けを使う場合はnullを返します。指定されたキーと現在マップされている値に対するマッピングの計算を試みます(現在のマッピングが存在しない場合はnull)。computeIfAbsent(K key, Function<? super K, ? extends V> mappingFunction) 指定されたキーがまだ値に関連付けられていない場合、指定されたマッピング関数を使用してその値の計算を試行し、nullでない場合はそれをこのマップに入力します。computeIfPresent(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction) 指定されたキーの値が存在する場合、キーと現在マップされている値から新しいマッピングの計算を試みます。booleancontainsKey(Object key) 指定されたキーのマッピングがこのマップに含まれている場合にtrueを返します。booleancontainsValue(Object value) このマップが1つまたは複数のキーと指定された値をマッピングしている場合にtrueを返します。このマップに含まれるキーの逆順のNavigableSetビューを返します。このマップ内に保持されているマッピングの逆順のビューを返します。entrySet()このマップに含まれるマッピングのSetビューを返します。boolean指定されたオブジェクトがこのマップと等しいかどうかを比較します。このマップ内の最小のキーに関連付けられたキーと値のマッピングを返します。マップが空の場合、nullを返します。firstKey()マップ内に現在ある最初(下端)のキーを返します。floorEntry(K key) 指定されたキー以下の、最大のキーに関連付けられたキーと値のマッピングを返します。そのようなキーが存在しない場合は、nullを返します。指定されたキーと等しいかそれよりも小さいキーの中で最大のものを返します。そのようなキーが存在しない場合はnullを返します。指定されたキーがマップされている値を返します。そのキーのマッピングがこのマップに含まれていない場合はnullを返します。getOrDefault(Object key, V defaultValue) 指定されたキーがマップされる値を返します。このマップにそのキーのマッピングが含まれていない場合は、指定されたdefaultValueを返します。このマップのtoKeyよりも確実に小さいキーを持つ部分のビューを返します。このマップのtoKeyよりも小さいキー(inclusiveがtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビューを返します。higherEntry(K key) 指定されたキーよりも確実に大きい、最小のキーに関連付けられたキーと値のマッピングを返します。そのようなキーが存在しない場合は、nullを返します。指定されたキーよりも確実に大きいキーの中で最小のものを返します。そのようなキーが存在しない場合はnullを返します。booleanisEmpty()このマップがキーと値のマッピングを保持しない場合にtrueを返します。keySet()このマップに含まれるキーのNavigableSetビューを返します。このマップ内の最大のキーに関連付けられたキーと値のマッピングを返します。マップが空の場合、nullを返します。lastKey()マップ内に現在ある最後(上端)のキーを返します。lowerEntry(K key) 指定されたキーよりも確実に小さい、最大のキーに関連付けられたキーと値のマッピングを返します。そのようなキーが存在しない場合は、nullを返します。指定されたキーよりも確実に小さいキーの中で最大のものを返します。そのようなキーが存在しない場合はnullを返します。指定されたキーがまだ値と関連付けられていない場合は、指定された値に関連付けます。このマップに含まれるキーのNavigableSetビューを返します。このマップ内の最小のキーに関連付けられたキーと値のマッピングを削除し、返します。マップが空の場合、nullを返します。このマップ内の最大のキーに関連付けられたキーと値のマッピングを削除し、返します。マップが空の場合、nullを返します。指定された値と指定されたキーをこのマップに関連付けます。UnsupportedOperationExceptionをスローします。putIfAbsent(K key, V value) 指定されたキーがまだ値と関連付けられていない場合は、指定された値に関連付けます。UnsupportedOperationExceptionをスローします。指定されたキーのマッピングがあればマップから削除します。boolean指定された値にキーが現在マッピングされている場合にのみ、そのキーのエントリを削除します。キーが値に現在マッピングされている場合にのみ、そのキーのエントリを置換します。boolean指定された値にキーが現在マッピングされている場合にのみ、そのキーのエントリを置換します。intsize()このマップ内のキー値マッピングの数を返します。このマップのfromKey-toKeyのキー範囲を持つ部分のビューを返します。このマップのfromKey(これを含む) -toKey(これを含まない)のキー範囲を持つ部分のビューを返します。このマップのfromKey以上のキーを持つ部分のビューを返します。このマップのfromKeyよりも大きいキー(inclusiveがtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビューを返します。values()このマップに含まれる値のCollectionビューを返します。インタフェースjava.util.concurrent.ConcurrentMapで宣言されたメソッド
forEach, replaceAllインタフェースjava.util.NavigableMapで宣言されたメソッド
reversedインタフェースjava.util.SequencedMapで宣言されたメソッド
sequencedEntrySet, sequencedKeySet, sequencedValues
-
コンストラクタの詳細
-
ConcurrentSkipListMap
public ConcurrentSkipListMap()キーの自然順序付けに従ってソートされた、新しい空のマップを作成します。 -
ConcurrentSkipListMap
public ConcurrentSkipListMap(Comparator<? super K> comparator) 指定されたコンパレータに従ってソートされた、新しい空のマップを作成します。- パラメータ:
comparator- このマップの順序付けを行うために使用されるコンパレータ。nullの場合、キーの自然順序付けが使用される。
-
ConcurrentSkipListMap
指定されたマップと同じマッピングを持ち、キーの自然順序付けに従ってソートされた新しいマップを構築します。- パラメータ:
m- マッピングがこのマップに配置されるマップ- スロー:
ClassCastException-m内のキーがComparableでないか、または相互に比較可能でない場合NullPointerException- 指定されたマップ、またはそのキーと値のいずれかがnullの場合
-
ConcurrentSkipListMap
指定されたソート・マップと同じマッピングを持ち、同じ順序付けを使用する、新しいマップを構築します。- パラメータ:
m- マッピングがこのマップに配置され、コンパレータがこのマップのソートに使用される、ソートされたマップ- スロー:
NullPointerException- 指定されたソートされたマップ、またはそのキーと値のいずれかがnullの場合
-
-
メソッドの詳細
-
clone
public ConcurrentSkipListMap<K,V> clone()ConcurrentSkipListMapのインスタンスのシャロー・コピーを返します。 そのキーと値は複製されません。- オーバーライド:
- クラス
AbstractMap<K,のV> clone - 戻り値:
- このマップのシャロー・コピー
- 関連項目:
-
containsKey
public boolean containsKey(Object key) 指定されたキーのマッピングがこのマップに含まれている場合にtrueを返します。- 定義:
- インタフェース
Map<K,内のV> containsKey - オーバーライド:
- クラス
AbstractMap<K,のV> containsKey - パラメータ:
key- このマップ内にあるかどうかが判定されるキー- 戻り値:
- 指定されたキーのマッピングがこのマップに含まれている場合は
true - スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーがnullである場合
-
get
指定されたキーがマップされている値を返します。そのキーのマッピングがこのマップに含まれていない場合はnullを返します。つまり、マップの順序付けに従って
keyがkに等しくなるような、キーkから値vへのマッピングがこのマップに含まれている場合、このメソッドはvを返します。それ以外の場合は、nullを返します。 (このようなマッピングは1つのみ存在できます。)- 定義:
- インタフェース
Map<K,内のV> get - オーバーライド:
- クラス
AbstractMap<K,のV> get - パラメータ:
key- 関連付けられた値が返されるキー- 戻り値:
- 指定されたキーがマップされている値。そのキーのマッピングがこのマップに含まれていない場合は
null - スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーがnullである場合
-
getOrDefault
指定されたキーがマップされる値を返します。このマップにそのキーのマッピングが含まれていない場合は、指定されたdefaultValueを返します。- 定義:
- インタフェース
ConcurrentMap<K,内のV> getOrDefault - 定義:
- インタフェース
Map<K,内のV> getOrDefault - パラメータ:
key- キーdefaultValue- このマップに指定されたキーのマッピングが含まれていない場合に返す値- 戻り値:
- 存在する場合はキーのマッピング。それ以外の場合はdefaultValue
- スロー:
NullPointerException- 指定されたキーがnullである場合- 導入されたバージョン:
- 1.8
-
put
指定された値と指定されたキーをこのマップに関連付けます。 マップが以前にこのキーのマッピングを保持していた場合、古い値が置き換えられます。- 定義:
- インタフェース
Map<K,内のV> put - オーバーライド:
- クラス
AbstractMap<K,のV> put - パラメータ:
key- 指定された値が関連付けられるキーvalue- 指定されたキーに関連付けられる値- 戻り値:
- 指定されたキーに関連付けられた以前の値。キーのマッピングがなかった場合は
null。 - スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーまたは値がnullの場合
-
remove
指定されたキーのマッピングがあればマップから削除します。- 定義:
- インタフェース
Map<K,内のV> remove - オーバーライド:
- クラス
AbstractMap<K,のV> remove - パラメータ:
key- マッピングを削除する必要があるキー- 戻り値:
- 指定されたキーに関連付けられた以前の値。キーのマッピングがなかった場合は
null。 - スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーがnullである場合
-
containsValue
public boolean containsValue(Object value) このマップが1つまたは複数のキーと指定された値をマッピングしている場合にtrueを返します。 このオペレーションはマップのサイズに正比例した時間がかかります。 さらに、このメソッドの実行中にマップが変更される可能性があり、その場合は返される結果が不正確になることがあります。- 定義:
- インタフェース
Map<K,内のV> containsValue - オーバーライド:
- クラス
AbstractMap<K,のV> containsValue - パラメータ:
value- このマップにあるかどうかが判定される値- 戻り値:
valueへのマッピングが存在する場合はtrue。それ以外の場合はfalse- スロー:
NullPointerException- 指定された値がnullである場合
-
size
public int size()このマップ内のキー値マッピングの数を返します。 マップにInteger.MAX_VALUEを超える要素が含まれている場合は、Integer.MAX_VALUEを返します。 -
isEmpty
public boolean isEmpty()このマップがキーと値のマッピングを保持しない場合にtrueを返します。 -
clear
public void clear()すべてのマッピングをマップから削除します。 -
computeIfAbsent
指定されたキーがまだ値に関連付けられていない場合、指定されたマッピング関数を使用してその値の計算を試行し、nullでない場合はそれをこのマップに入力します。 値が存在しない場合にのみこの関数が原子的に1回適用されるという保証はありません。- 定義:
- インタフェース
ConcurrentMap<K,内のV> computeIfAbsent - 定義:
- インタフェース
Map<K,内のV> computeIfAbsent - パラメータ:
key- 指定された値が関連付けられるキーmappingFunction- 値を計算するための関数- 戻り値:
- 指定されたキーに関連付けられている現在の(既存の、または計算された)値。計算された値がnullである場合はnull
- スロー:
NullPointerException- 指定されたキーがnullであるか、またはmappingFunctionがnullである場合- 導入されたバージョン:
- 1.8
-
computeIfPresent
指定されたキーの値が存在する場合、キーと現在マップされている値から新しいマッピングの計算を試みます。 この関数が原子的に1回適用されるという保証はありません。- 定義:
- インタフェース
ConcurrentMap<K,内のV> computeIfPresent - 定義:
- インタフェース
Map<K,内のV> computeIfPresent - パラメータ:
key- 値を関連付けることができるキーremappingFunction- 値を計算するための関数- 戻り値:
- 指定されたキーに関連付けられる新しい値。存在しない場合はnull
- スロー:
NullPointerException- 指定されたキーがnullであるか、またはremappingFunctionがnullである場合- 導入されたバージョン:
- 1.8
-
compute
指定されたキーと現在マップされている値に対するマッピングの計算を試みます(現在のマッピングが存在しない場合はnull)。 この関数が原子的に1回適用されるという保証はありません。- 定義:
- インタフェース
ConcurrentMap<K,内のV> compute - 定義:
- インタフェース
Map<K,内のV> compute - パラメータ:
key- 指定された値が関連付けられるキーremappingFunction- 値を計算するための関数- 戻り値:
- 指定されたキーに関連付けられる新しい値。存在しない場合はnull
- スロー:
NullPointerException- 指定されたキーがnullであるか、またはremappingFunctionがnullである場合- 導入されたバージョン:
- 1.8
-
merge
指定されたキーがまだ値と関連付けられていない場合は、指定された値に関連付けます。 それ以外の場合は、指定された再マッピング関数の結果で値を置換し、nullの場合は削除します。 この関数が原子的に1回適用されるという保証はありません。- 定義:
- インタフェース
ConcurrentMap<K,内のV> merge - 定義:
- インタフェース
Map<K,内のV> merge - パラメータ:
key- 指定された値が関連付けられるキーvalue- 値が存在しない場合に使用する値remappingFunction- 値が存在する場合に値を再計算するための関数- 戻り値:
- 指定されたキーに関連付けられる新しい値。存在しない場合はnull
- スロー:
NullPointerException- 指定されたキーまたは値がnullであるか、あるいはremappingFunctionがnullである場合- 導入されたバージョン:
- 1.8
-
keySet
public NavigableSet<K> keySet()このマップに含まれるキーのNavigableSetビューを返します。セットのイテレータは、キーを昇順で返します。 セットのスプリッテレータはさらに、
Spliterator.CONCURRENT、Spliterator.NONNULL、Spliterator.SORTEDおよびSpliterator.ORDERED(キーの昇順である検出順序で)を報告します。「マップの比較」が
nullの場合、「スプリッタのコンパレータ」はnullです。 それ以外の場合、スプリッテレータのコンパレータはマップのコンパレータと同じであるか、同じ全体順序付けを義務付けます。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。 セットは要素の削除をサポートします。
Iterator.remove、Set.remove、removeAll、retainAll、およびclearオペレーションで対応するマッピングをマップから削除します。addまたはaddAll操作はサポートされていません。ビューのイテレータおよびスプリッテレータは、弱一貫性を持っています。
このメソッドは、メソッド
navigableKeySetと同等です。 -
values
public Collection<V> values()このマップに含まれる値のCollectionビューを返します。コレクションのイテレータは、値を対応するキーの昇順で返します。 コレクションのスプリッテレータはさらに、
Spliterator.CONCURRENT、Spliterator.NONNULLおよびSpliterator.ORDERED(キーの昇順である検出順序で)を報告します。コレクションはマップと連動しているので、マップに対する変更はコレクションに反映され、またコレクションに対する変更はマップに反映されます。 コレクションは要素の削除をサポートしており、対応するマッピングをマップから削除できます。削除は、
Iterator.remove、Collection.remove、removeAll、retainAll、およびclearオペレーションを通して行います。addまたはaddAll操作はサポートされていません。ビューのイテレータおよびスプリッテレータは、弱一貫性を持っています。
-
entrySet
このマップに含まれるマッピングのSetビューを返します。セットのイテレータは、エントリをキーの昇順で返します。 セットのスプリッテレータはさらに、
Spliterator.CONCURRENT、Spliterator.NONNULL、Spliterator.SORTEDおよびSpliterator.ORDERED(キーの昇順である検出順序で)を報告します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。 セットは要素の削除をサポートしており、対応するマッピングをマップから削除できます。削除は、
Iterator.remove、Set.remove、removeAll、retainAll、およびclearオペレーションを通して行います。addまたはaddAll操作はサポートされていません。ビューのイテレータおよびスプリッテレータは、弱一貫性を持っています。
iteratorまたはspliteratorによってトラバースされるMap.Entryの要素は、setValueオペレーションをサポートしません。 -
descendingMap
public ConcurrentNavigableMap<K,V> descendingMap()インタフェースからコピーされた説明:ConcurrentNavigableMapこのマップ内に保持されているマッピングの逆順のビューを返します。 降順マップはこのマップに連動しており、このマップでの変更は降順マップに反映され、その逆の場合も同様です。返されるマップの順序付けは、
Collections.reverseOrder(comparator())と同等になります。 式m.descendingMap().descendingMap()から返されるmのビューは基本的にmと同等になります。- 定義:
- インタフェース
ConcurrentNavigableMap<K,内のV> descendingMap - 定義:
- インタフェース
NavigableMap<K,内のV> descendingMap - 戻り値:
- このマップの逆順のビュー
-
descendingKeySet
public NavigableSet<K> descendingKeySet()インタフェースからコピーされた説明:ConcurrentNavigableMapこのマップに含まれるキーの逆順のNavigableSetビューを返します。 セットのイテレータは、キーを降順で返します。 セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。 セットは要素の削除をサポートします。Iterator.remove、Set.remove、removeAll、retainAll、およびclearオペレーションで対応するマッピングをマップから削除します。addまたはaddAll操作はサポートされていません。ビューのイテレータおよびスプリッテレータは、弱一貫性を持っています。
- 定義:
- インタフェース
ConcurrentNavigableMap<K,内のV> descendingKeySet - 定義:
- インタフェース
NavigableMap<K,内のV> descendingKeySet - 戻り値:
- このマップ内のキーのナビゲート可能な逆順セット・ビュー
-
equals
public boolean equals(Object o) 指定されたオブジェクトがこのマップと等しいかどうかを比較します。 指定されたオブジェクトもマップであり、2つのマップが同じマッピングを表す場合にtrueを返します。 つまり、m1.entrySet().equals(m2.entrySet())である場合、2つのマップm1とm2は同じマッピングを表します。 このオペレーションは、マップのいずれかがこのメソッドの実行中に並行して変更された場合、誤解を招きやすい結果を返すことがあります。 -
putIfAbsent
指定されたキーがまだ値と関連付けられていない場合は、指定された値に関連付けます。 これは、このmapと同等です:
ただし、アクションが原子的に実行される点が異なります。if (!map.containsKey(key)) return map.put(key, value); else return map.get(key);- 定義:
- インタフェース
ConcurrentMap<K,内のV> putIfAbsent - 定義:
- インタフェース
Map<K,内のV> putIfAbsent - パラメータ:
key- 指定された値が関連付けられるキーvalue- 指定されたキーに関連付けられる値- 戻り値:
- 指定されたキーに関連付けられた以前の値。キーのマッピングがなかった場合は
null。 - スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーまたは値がnullの場合
-
remove
指定された値にキーが現在マッピングされている場合にのみ、そのキーのエントリを削除します。 これは、このmapと同等です:
ただし、アクションが原子的に実行される点が異なります。if (map.containsKey(key) && Objects.equals(map.get(key), value)) { map.remove(key); return true; } else { return false; }- 定義:
- インタフェース
ConcurrentMap<K,内のV> remove - 定義:
- インタフェース
Map<K,内のV> remove - パラメータ:
key- 指定された値が関連付けられるキーvalue- 指定されたキーに関連付けられていると予想される値- 戻り値:
- 値が削除された場合は
true - スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーがnullである場合
-
replace
指定された値にキーが現在マッピングされている場合にのみ、そのキーのエントリを置換します。 これは、このmapと同等です:
ただし、アクションが原子的に実行される点が異なります。if (map.containsKey(key) && Objects.equals(map.get(key), oldValue)) { map.put(key, newValue); return true; } else { return false; }- 定義:
- インタフェース
ConcurrentMap<K,内のV> replace - 定義:
- インタフェース
Map<K,内のV> replace - パラメータ:
key- 指定された値が関連付けられるキーoldValue- 指定されたキーに関連付けられていると予想される値newValue- 指定されたキーに関連付けられる値- 戻り値:
- 値が置換された場合は
true - スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 引数が1つでもnullの場合
-
replace
キーが値に現在マッピングされている場合にのみ、そのキーのエントリを置換します。 これは、このmapと同等です:
ただし、アクションが原子的に実行される点が異なります。if (map.containsKey(key)) return map.put(key, value); else return null;- 定義:
- インタフェース
ConcurrentMap<K,内のV> replace - 定義:
- インタフェース
Map<K,内のV> replace - パラメータ:
key- 指定された値が関連付けられるキーvalue- 指定されたキーに関連付けられる値- 戻り値:
- 指定されたキーに関連付けられた以前の値。キーのマッピングがなかった場合は
null。 - スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーまたは値がnullの場合
-
comparator
public Comparator<? super K> comparator()インタフェースからコピーされた説明:SortedMapこのマップ内のキーを順序付けするのに使うコンパレータを返します。ただし、このマップがそのキーの自然順序付けを使う場合はnullを返します。- 定義:
- インタフェース
SortedMap<K,内のV> comparator - 戻り値:
- このマップ内のキーを順序付けするのに使うコンパレータ。このマップがそのキーの自然順序付けを使う場合は
null
-
firstKey
public K firstKey()インタフェースからコピーされた説明:SortedMapマップ内に現在ある最初(下端)のキーを返します。- 定義:
- インタフェース
SortedMap<K,内のV> firstKey - 戻り値:
- マップ内に現在ある最初(下端)のキー
- スロー:
NoSuchElementException- マップが空の場合
-
lastKey
public K lastKey()インタフェースからコピーされた説明:SortedMapマップ内に現在ある最後(上端)のキーを返します。- 定義:
- インタフェース
SortedMap<K,内のV> lastKey - 戻り値:
- マップ内に現在ある最後(上端)のキー
- スロー:
NoSuchElementException- マップが空の場合
-
putFirst
UnsupportedOperationExceptionをスローします。 このマップの比較メソッドによって誘起される検出順序によってマッピングの位置が決定されるため、明示的な配置はサポートされていません。- 定義:
- インタフェース
SequencedMap<K,内のV> putFirst - 定義:
- インタフェース
SortedMap<K,内のV> putFirst - パラメータ:
k- キーv- 値- 戻り値:
- 以前kに関連付けられていた値。関連付けられていない場合はnull
- スロー:
UnsupportedOperationException- 常時- 導入されたバージョン:
- 21
-
putLast
UnsupportedOperationExceptionをスローします。 このマップの比較メソッドによって誘起される検出順序によってマッピングの位置が決定されるため、明示的な配置はサポートされていません。- 定義:
- インタフェース
SequencedMap<K,内のV> putLast - 定義:
- インタフェース
SortedMap<K,内のV> putLast - パラメータ:
k- キーv- 値- 戻り値:
- 以前kに関連付けられていた値。関連付けられていない場合はnull
- スロー:
UnsupportedOperationException- 常時- 導入されたバージョン:
- 21
-
subMap
public ConcurrentNavigableMap<K,V> subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive) インタフェースからコピーされた説明:NavigableMapこのマップのfromKey-toKeyのキー範囲を持つ部分のビューを返します。fromKeyとtoKeyが等しい場合、返されるマップは、fromInclusiveとtoInclusiveの両方がtrueでないかぎり、空になります。 返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。 返されるマップは、このマップがサポートするオプションのマップ・オペレーションをすべてサポートします。返されるマップは、その範囲外のキーが挿入されようとしたり、端点のいずれかがその範囲外にあるようなサブマップが構築されようとしたりすると、
IllegalArgumentExceptionをスローします。- 定義:
- インタフェース
ConcurrentNavigableMap<K,内のV> subMap - 定義:
- インタフェース
NavigableMap<K,内のV> subMap - パラメータ:
fromKey- 返されるマップ内のキーの下端点fromInclusive- 返されるビューに下端点が含まれる場合はtruetoKey- 返されるマップ内のキーの上端点toInclusive- 返されるビューに上端点が含まれる場合はtrue- 戻り値:
- このマップの
fromKey-toKeyのキー範囲を持つ部分のビュー - スロー:
ClassCastException- このマップのコンパレータを使用して(このマップがコンパレータを持たない場合は自然順序付けを使用して)、fromKeyとtoKeyを相互に比較できない場合。 実装は、マップ内に現在存在しているキーとfromKeyまたはtoKeyとを比較できない場合にこの例外をスローできる。ただし、必須ではない。NullPointerException-fromKeyまたはtoKeyがnullである場合IllegalArgumentException-fromKeyがtoKeyよりも大きい場合、またはこのマップ自体が制限された範囲を持っており、fromKeyまたはtoKeyがその範囲から外れている場合
-
headMap
public ConcurrentNavigableMap<K,V> headMap(K toKey, boolean inclusive) インタフェースからコピーされた説明:NavigableMapこのマップのtoKeyよりも小さいキー(inclusiveがtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビューを返します。 返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。 返されるマップは、このマップがサポートするオプションのマップ・オペレーションをすべてサポートします。返されるマップは、その範囲外のキーが挿入されようとすると、
IllegalArgumentExceptionをスローします。- 定義:
- インタフェース
ConcurrentNavigableMap<K,内のV> headMap - 定義:
- インタフェース
NavigableMap<K,内のV> headMap - パラメータ:
toKey- 返されるマップ内のキーの上端点inclusive- 返されるビューに上端点が含まれる場合はtrue- 戻り値:
- このマップの
toKeyよりも小さいキー(inclusiveがtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビュー - スロー:
ClassCastException-toKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、toKeyがComparableを実装していない場合)。 実装は、マップ内に現在存在しているキーとtoKeyとを比較できない場合にこの例外をスローできる。ただし、必須ではないNullPointerException-toKeyがnullである場合IllegalArgumentException- このマップ自体が制限された範囲を持っており、toKeyがその範囲から外れている場合
-
tailMap
public ConcurrentNavigableMap<K,V> tailMap(K fromKey, boolean inclusive) インタフェースからコピーされた説明:NavigableMapこのマップのfromKeyよりも大きいキー(inclusiveがtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビューを返します。 返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。 返されるマップは、このマップがサポートするオプションのマップ・オペレーションをすべてサポートします。返されるマップは、その範囲外のキーが挿入されようとすると、
IllegalArgumentExceptionをスローします。- 定義:
- インタフェース
ConcurrentNavigableMap<K,内のV> tailMap - 定義:
- インタフェース
NavigableMap<K,内のV> tailMap - パラメータ:
fromKey- 返されるマップ内のキーの下端点inclusive- 返されるビューに下端点が含まれる場合はtrue- 戻り値:
- このマップの
fromKeyよりも大きいキー(inclusiveがtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビュー - スロー:
ClassCastException-fromKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、fromKeyがComparableを実装していない場合)。 実装は、マップ内に現在存在しているキーとfromKeyとを比較できない場合にこの例外をスローできる。ただし、必須ではないNullPointerException-fromKeyがnullである場合IllegalArgumentException- このマップ自体が制限された範囲を持っており、fromKeyがその範囲から外れている場合
-
subMap
public ConcurrentNavigableMap<K,V> subMap(K fromKey, K toKey) インタフェースからコピーされた説明:NavigableMapこのマップのfromKey(これを含む) -toKey(これを含まない)のキー範囲を持つ部分のビューを返します。fromKeyとtoKeyが等しい場合は、空のマップが返されます。 返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。 返されるマップは、このマップがサポートするオプションのマップ・オペレーションをすべてサポートします。返されるマップは、その範囲外のキーが挿入されようとすると、
IllegalArgumentExceptionをスローします。subMap(fromKey, true, toKey, false)と同等です。- 定義:
- インタフェース
ConcurrentNavigableMap<K,内のV> subMap - 定義:
- インタフェース
NavigableMap<K,内のV> subMap - 定義:
- インタフェース
SortedMap<K,内のV> subMap - パラメータ:
fromKey- 返されるマップ内のキーの下端点(これを含む)toKey- 返されるマップ内のキーの上端点(これを含まない)- 戻り値:
- このマップの
fromKey(これを含む)からtoKey(これを含まない)のキー範囲を持つ部分のビュー - スロー:
ClassCastException- このマップのコンパレータを使用して(このマップがコンパレータを持たない場合は自然順序付けを使用して)、fromKeyとtoKeyを相互に比較できない場合。 実装は、マップ内に現在存在しているキーとfromKeyまたはtoKeyとを比較できない場合にこの例外をスローできる。ただし、必須ではない。NullPointerException-fromKeyまたはtoKeyがnullである場合IllegalArgumentException-fromKeyがtoKeyよりも大きい場合、またはこのマップ自体が制限された範囲を持っており、fromKeyまたはtoKeyがその範囲から外れている場合
-
headMap
public ConcurrentNavigableMap<K,V> headMap(K toKey) インタフェースからコピーされた説明:NavigableMapこのマップのtoKeyよりも確実に小さいキーを持つ部分のビューを返します。 返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。 返されるマップは、このマップがサポートするオプションのマップ・オペレーションをすべてサポートします。返されるマップは、その範囲外のキーが挿入されようとすると、
IllegalArgumentExceptionをスローします。headMap(toKey, false)と同等です。- 定義:
- インタフェース
ConcurrentNavigableMap<K,内のV> headMap - 定義:
- インタフェース
NavigableMap<K,内のV> headMap - 定義:
- インタフェース
SortedMap<K,内のV> headMap - パラメータ:
toKey- 返されるマップ内のキーの上端点(これを含まない)- 戻り値:
- このマップの
toKeyよりも確実に小さいキーを持つ部分のビュー - スロー:
ClassCastException-toKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、toKeyがComparableを実装していない場合)。 実装は、マップ内に現在存在しているキーとtoKeyとを比較できない場合にこの例外をスローできる。ただし、必須ではないNullPointerException-toKeyがnullである場合IllegalArgumentException- このマップ自体が制限された範囲を持っており、toKeyがその範囲から外れている場合
-
tailMap
public ConcurrentNavigableMap<K,V> tailMap(K fromKey) インタフェースからコピーされた説明:NavigableMapこのマップのfromKey以上のキーを持つ部分のビューを返します。 返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。 返されるマップは、このマップがサポートするオプションのマップ・オペレーションをすべてサポートします。返されるマップは、その範囲外のキーが挿入されようとすると、
IllegalArgumentExceptionをスローします。tailMap(fromKey, true)と同等です。- 定義:
- インタフェース
ConcurrentNavigableMap<K,内のV> tailMap - 定義:
- インタフェース
NavigableMap<K,内のV> tailMap - 定義:
- インタフェース
SortedMap<K,内のV> tailMap - パラメータ:
fromKey- 返されるマップ内のキーの下端点(これを含む)- 戻り値:
- このマップの
fromKey以上のキーを持つ部分のビュー - スロー:
ClassCastException-fromKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、fromKeyがComparableを実装していない場合)。 実装は、マップ内に現在存在しているキーとfromKeyとを比較できない場合にこの例外をスローできる。ただし、必須ではないNullPointerException-fromKeyがnullである場合IllegalArgumentException- このマップ自体が制限された範囲を持っており、fromKeyがその範囲から外れている場合
-
lowerEntry
指定されたキーよりも確実に小さい、最大のキーに関連付けられたキーと値のマッピングを返します。そのようなキーが存在しない場合は、nullを返します。 返されるエントリは、Entry.setValueメソッドをサポートしません。- 定義:
- インタフェース
NavigableMap<K,内のV> lowerEntry - パラメータ:
key- キー- 戻り値:
keyよりも小さいキーの中で最大のものを持つエントリ。そのようなキーが存在しない場合はnull- スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーがnullである場合
-
lowerKey
インタフェースからコピーされた説明:NavigableMap指定されたキーよりも確実に小さいキーの中で最大のものを返します。そのようなキーが存在しない場合はnullを返します。- 定義:
- インタフェース
NavigableMap<K,内のV> lowerKey - パラメータ:
key- キー- 戻り値:
keyよりも小さいキーの中で最大のもの。そのようなキーが存在しない場合はnull- スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーがnullである場合
-
floorEntry
指定されたキー以下の、最大のキーに関連付けられたキーと値のマッピングを返します。そのようなキーが存在しない場合は、nullを返します。 返されるエントリは、Entry.setValueメソッドをサポートしません。- 定義:
- インタフェース
NavigableMap<K,内のV> floorEntry - パラメータ:
key- キー- 戻り値:
keyと等しいか、それよりも小さいキーの中で最大のものを持つエントリ。そのようなキーが存在しない場合はnull- スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーがnullである場合
-
floorKey
インタフェースからコピーされた説明:NavigableMap指定されたキーと等しいかそれよりも小さいキーの中で最大のものを返します。そのようなキーが存在しない場合はnullを返します。- 定義:
- インタフェース
NavigableMap<K,内のV> floorKey - パラメータ:
key- キー- 戻り値:
keyと等しいか、それよりも小さいキーの中で最大のもの。そのようなキーが存在しない場合はnull- スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーがnullである場合
-
ceilingEntry
指定されたキー以上の、最小のキーと関連するキーと値のマッピングを返します。そのようなエントリが存在しない場合は、nullを返します。 返されるエントリは、Entry.setValueメソッドをサポートしません。- 定義:
- インタフェース
NavigableMap<K,内のV> ceilingEntry - パラメータ:
key- キー- 戻り値:
keyと等しいか、それよりも大きいキーの中で最小のものを持つエントリ。そのようなキーが存在しない場合はnull- スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーがnullである場合
-
ceilingKey
インタフェースからコピーされた説明:NavigableMap指定されたキーと等しいかそれよりも大きいキーの中で最小のものを返します。そのようなキーが存在しない場合はnullを返します。- 定義:
- インタフェース
NavigableMap<K,内のV> ceilingKey - パラメータ:
key- キー- 戻り値:
keyと等しいか、それよりも大きいキーの中で最小のもの。そのようなキーが存在しない場合はnull- スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーがnullである場合
-
higherEntry
指定されたキーよりも確実に大きい、最小のキーに関連付けられたキーと値のマッピングを返します。そのようなキーが存在しない場合は、nullを返します。 返されるエントリは、Entry.setValueメソッドをサポートしません。- 定義:
- インタフェース
NavigableMap<K,内のV> higherEntry - パラメータ:
key- キー- 戻り値:
keyよりも大きいキーの中で最小のものを持つエントリ。そのようなキーが存在しない場合はnull- スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーがnullである場合
-
higherKey
インタフェースからコピーされた説明:NavigableMap指定されたキーよりも確実に大きいキーの中で最小のものを返します。そのようなキーが存在しない場合はnullを返します。- 定義:
- インタフェース
NavigableMap<K,内のV> higherKey - パラメータ:
key- キー- 戻り値:
keyよりも大きいキーの中で最小のもの。そのようなキーが存在しない場合はnull- スロー:
ClassCastException- 指定されたキーがマップ内に現在あるキーと比較できない場合NullPointerException- 指定されたキーがnullである場合
-
firstEntry
このマップ内の最小のキーに関連付けられたキーと値のマッピングを返します。マップが空の場合、nullを返します。 返されるエントリは、Entry.setValueメソッドをサポートしません。- 定義:
- インタフェース
NavigableMap<K,内のV> firstEntry - 定義:
- インタフェース
SequencedMap<K,内のV> firstEntry - 戻り値:
- 最小のキーを持つエントリ。このマップが空の場合は
null
-
lastEntry
このマップ内の最大のキーに関連付けられたキーと値のマッピングを返します。マップが空の場合、nullを返します。 返されるエントリは、Entry.setValueメソッドをサポートしません。- 定義:
- インタフェース
NavigableMap<K,内のV> lastEntry - 定義:
- インタフェース
SequencedMap<K,内のV> lastEntry - 戻り値:
- 最大のキーを持つエントリ。このマップが空の場合は
null
-
pollFirstEntry
このマップ内の最小のキーに関連付けられたキーと値のマッピングを削除し、返します。マップが空の場合、nullを返します。 返されるエントリは、Entry.setValueメソッドをサポートしません。- 定義:
- インタフェース
NavigableMap<K,内のV> pollFirstEntry - 定義:
- インタフェース
SequencedMap<K,内のV> pollFirstEntry - 戻り値:
- このマップの削除された最初のエントリ。このマップが空の場合は
null
-
pollLastEntry
このマップ内の最大のキーに関連付けられたキーと値のマッピングを削除し、返します。マップが空の場合、nullを返します。 返されるエントリは、Entry.setValueメソッドをサポートしません。- 定義:
- インタフェース
NavigableMap<K,内のV> pollLastEntry - 定義:
- インタフェース
SequencedMap<K,内のV> pollLastEntry - 戻り値:
- このマップの削除された最後のエントリ。このマップが空の場合は
null
-