java.lang.Object
java.util.concurrent.ConcurrentHashMap.KeySetView<K,V>
- すべての実装されたインタフェース:
Serializable,Iterable<K>,Collection<K>,Set<K>
- 含まれているクラス:
- ConcurrentHashMap<K,V>
public static classConcurrentHashMap.KeySetView<K,V> extends Object implements Set<K>, Serializable
キーの
SetとしてのConcurrentHashMapのビューです。オプションで、共通の値にマップすることによって追加を有効化できます。 このクラスは直接インスタンス化できません。 keySet()、keySet(V)、newKeySet()、newKeySet(int)を参照してください。 - 導入されたバージョン:
- 1.8
- 関連項目:
- 直列化された形式
-
メソッドのサマリー
修飾子と型メソッド説明booleanバッキング・マップ内のデフォルトのマップされた値(定義されている場合)にキーをマップすることにより、指定されたキーをこのセット・ビューに追加します。booleanaddAll(Collection<? extends K> c)指定されたコレクションのすべての要素をこのセットに追加します。各要素に対してadd(K)を呼び出した場合と同様です。voidclear()このビューのバッキング・マップからすべてのマッピングを削除することにより、このビューからすべての要素を削除します。boolean指定された要素がコレクションに含まれている場合にtrueを返します。booleancontainsAll(Collection<?> c)指定されたコレクションのすべての要素がこのコレクション内にある場合はtrueを返します。booleanこのオブジェクトと他のオブジェクトが等しいかどうかを示します。getMap()このビューのバッキング・マップを返します。追加に対するデフォルトのマップされた値を返します。追加がサポートされていない場合はnullを返します。inthashCode()オブジェクトのハッシュ・コード値を返します。booleanisEmpty()このコレクションに要素がない場合にtrueを返します。iterator()コレクションの要素のイテレータを返します。booleanバッキング・マップからキー(およびそれに対応する値)を削除することで、このマップ・ビューからキーを削除します。booleanremoveAll(Collection<?> c)指定されたコレクションにも格納されているこのコレクションのすべての要素を削除します(オプションの操作)。booleanretainAll(Collection<?> c)このコレクションにおいて、指定されたコレクションに格納されている要素だけを保持します(オプションの操作)。intsize()このコレクション中の要素の数を返します。Object[]toArray()このコレクションの要素がすべて格納されている配列を返します。<T> T[]toArray(T[] a)このコレクション内のすべての要素を保持する配列を返します。返される配列の実行時の型は、指定された配列の型です。toString()このコレクションの文字列表現を返します。クラス java.lang.Objectで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitインタフェース java.util.Collectionで宣言されたメソッド
parallelStream, removeIf, stream, toArrayインタフェース java.util.Setで宣言されたメソッド
clear, containsAll, isEmpty, removeAll, retainAll, size, spliterator, toArray, toArray
-
メソッドの詳細
-
getMappedValue
public V getMappedValue()追加に対するデフォルトのマップされた値を返します。追加がサポートされていない場合はnullを返します。- 戻り値:
- 追加に対するデフォルトのマップされた値。サポートされていない場合は
null
-
contains
public boolean contains(Object o)指定された要素がコレクションに含まれている場合にtrueを返します。 より正式には、trueは、このコレクションに少なくとも1つの要素e(Objects.equals(o, e)など)が含まれている場合にのみ返されます。- 定義:
contains、インタフェース:Collection<K>- 定義:
contains、インタフェース:Set<K>- パラメータ:
o- このコレクション内にあるかどうかが判定される要素- 戻り値:
- 指定された要素がこのコレクション内にある場合は
true - 例外:
NullPointerException- 指定されたキーがnullである場合
-
remove
public boolean remove(Object o)バッキング・マップからキー(およびそれに対応する値)を削除することで、このマップ・ビューからキーを削除します。 そのキーがマップにない場合は、何も行いません。- 定義:
remove、インタフェース:Collection<K>- 定義:
remove、インタフェース:Set<K>- パラメータ:
o- バッキング・マップから削除されるキー- 戻り値:
- 指定された要素がバッキング・マップに含まれていた場合は
true - 例外:
NullPointerException- 指定されたキーがnullである場合
-
iterator
コレクションの要素のイテレータを返します。返されるイテレータは弱一貫性を保持します。
-
add
public boolean add(K e)バッキング・マップ内のデフォルトのマップされた値(定義されている場合)にキーをマップすることにより、指定されたキーをこのセット・ビューに追加します。- 定義:
add、インタフェース:Collection<K>- 定義:
add、インタフェース:Set<K>- パラメータ:
e- 追加されるキー- 戻り値:
- 呼出しの結果としてこのセットが変更された場合は
true - 例外:
NullPointerException- 指定されたキーがnullである場合UnsupportedOperationException- 追加に対するデフォルトのマップされた値が指定されていなかった場合
-
addAll
public boolean addAll(Collection<? extends K> c)指定されたコレクションのすべての要素をこのセットに追加します。各要素に対してadd(K)を呼び出した場合と同様です。- 定義:
addAll、インタフェース:Collection<K>- 定義:
addAll、インタフェース:Set<K>- パラメータ:
c- このセットに挿入される要素- 戻り値:
- 呼出しの結果としてこのセットが変更された場合は
true - 例外:
NullPointerException- コレクションまたはそのいずれかの要素がnullである場合UnsupportedOperationException- 追加に対するデフォルトのマップされた値が指定されていなかった場合- 関連項目:
Set.add(Object)
-
hashCode
public int hashCode()次のクラスからコピーされた説明:Objectオブジェクトのハッシュ・コード値を返します。 このメソッドは、HashMapによって提供されるハッシュ表などの、ハッシュ表の利点のためにサポートされています。hashCodeの一般的な規則は次のとおりです。- Javaアプリケーションの実行中に同じオブジェクトに対して複数回呼び出された場合は常に、このオブジェクトに対する
equalsの比較で使用される情報が変更されていなければ、hashCodeメソッドは常に同じ整数を返す必要があります。 ただし、この整数は同じアプリケーションの実行ごとに同じである必要はありません。 equals(Object)メソッドに従って2つのオブジェクトが等しい場合は、2つの各オブジェクトに対するhashCodeメソッドの呼出しによって同じ整数の結果が生成される必要があります。Object.equals(java.lang.Object)メソッドに従って2つのオブジェクトが等しくない場合は、2つの各オブジェクトに対するhashCodeメソッドの呼出しによって異なる整数の結果が生成される必要はありません。 ただし、プログラマは、等しくないオブジェクトに対して異なる整数の結果を生成すると、ハッシュ表のパフォーマンスが向上する可能性があることに注意するようにしてください。
- 定義:
hashCode、インタフェース:Collection<K>- 定義:
hashCode、インタフェース:Set<K>- オーバーライド:
hashCode、クラス:Object- 戻り値:
- このオブジェクトのハッシュ・コード値。
- 関連項目:
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
- Javaアプリケーションの実行中に同じオブジェクトに対して複数回呼び出された場合は常に、このオブジェクトに対する
-
equals
public boolean equals(Object o)次のクラスからコピーされた説明:Objectこのオブジェクトと他のオブジェクトが等しいかどうかを示します。equalsメソッドは、null以外のオブジェクト参照での同値関係を実装します。- 反射性(reflexive): null以外の参照値
xについて、x.equals(x)はtrueを返します。 - 対称性(symmetric): null以外の参照値
xおよびyについて、y.equals(x)がtrueを返す場合に限り、x.equals(y)はtrueを返します。 - 推移性(transitive): null以外の参照値
x、y、およびzについて、x.equals(y)がtrueを返し、y.equals(z)がtrueを返す場合、x.equals(z)はtrueを返します。 - 一貫性(consistent): null以外の参照値
xおよびyについて、x.equals(y)の複数の呼出しは、このオブジェクトに対するequalsによる比較で使われた情報が変更されていなければ、一貫してtrueを返すか、一貫してfalseを返します。 - null以外の参照値
xについて、x.equals(null)はfalseを返します。
Objectクラスのequalsメソッドは、もっとも比較しやすいオブジェクトの同値関係を実装します。つまり、null以外の参照値xとyについて、このメソッドはxとyが同じオブジェクトを参照する(x == yがtrue)場合にだけtrueを返します。通常、このメソッドをオーバーライドする場合は、
hashCodeメソッドを常にオーバーライドして、「等価なオブジェクトは等価なハッシュ・コードを保持する必要がある」というhashCodeメソッドの汎用規約に従う必要があることに留意してください。- 定義:
equals、インタフェース:Collection<K>- 定義:
equals、インタフェース:Set<K>- オーバーライド:
equals、クラス:Object- パラメータ:
o- 比較対象の参照オブジェクト。- 戻り値:
- このオブジェクトがobj引数と同じである場合は
true、それ以外の場合はfalse。 - 関連項目:
Object.hashCode()、HashMap
- 反射性(reflexive): null以外の参照値
-
getMap
public ConcurrentHashMap<K,V> getMap()このビューのバッキング・マップを返します。- 戻り値:
- このビューのバッキング・マップ
-
clear
public final void clear()このビューのバッキング・マップからすべてのマッピングを削除することにより、このビューからすべての要素を削除します。- 定義:
- インタフェース
Collection<K>内のclear
-
size
public final int size()次のインタフェースからコピーされた説明:Collectionこのコレクション中の要素の数を返します。 このコレクションにInteger.MAX_VALUEより多くの要素がある場合は、Integer.MAX_VALUEを返します。- 定義:
- インタフェース
Collection<K>内のsize - 戻り値:
- このコレクションの要素数
-
isEmpty
public final boolean isEmpty()次のインタフェースからコピーされた説明:Collectionこのコレクションに要素がない場合にtrueを返します。- 定義:
- インタフェース
Collection<K>内のisEmpty - 戻り値:
- このコレクションに要素が含まれていない場合は
true
-
toArray
public final Object[] toArray()次のインタフェースからコピーされた説明:Collectionこのコレクションの要素がすべて格納されている配列を返します。 イテレータによって要素が返される順序をコレクションが保証する場合、このメソッドは同じ順序で要素を返さなければなりません。 返される配列「ランタイム・コンポーネント・タイプ」はObjectです。返される配列への参照をコレクションが維持しないという点で、この配列は安全です。 つまり、このメソッドは、コレクションが配列に連動している場合でも新しい配列を割り当てます。 このため、呼出し側は、返された配列を自由に変更できます。
- 定義:
- インタフェース
Collection<K>内のtoArray - 戻り値:
- 「ランタイム・コンポーネント・タイプ」が
Objectの配列。このコレクションのすべての要素を含む
-
toArray
public final <T> T[] toArray(T[] a)次のインタフェースからコピーされた説明:Collectionこのコレクション内のすべての要素を保持する配列を返します。返される配列の実行時の型は、指定された配列の型です。 コレクションが指定された配列に収まる場合は、その中に返されます。 そうでない場合は、指定された配列の実行時の型とコレクションのサイズを持つ新しい配列が割り当てられます。このコレクションが指定された配列に収まり、その配列にさらに余裕がある場合(つまり、配列がこのコレクションより多くの要素を持つ場合)、その配列内でコレクションの終端よりあとの要素は
nullに設定されます。 このコレクションにnull要素がないことを呼出し側が知っている場合にだけ、この特性を利用してコレクションの長さを判断できます。イテレータによって要素が返される順序をコレクションが保証する場合、このメソッドは同じ順序で要素を返さなければなりません。
- 定義:
- インタフェース
Collection<K>内のtoArray - 型パラメータ:
T- コレクションを格納する配列のコンポーネント型- パラメータ:
a- 配列が十分な大きさを持つ場合は、このコレクションの要素の格納先の配列。配列のサイズが十分でない場合は、同じ実行時の型で新しい配列が格納用として割り当てられる。- 戻り値:
- コレクションのすべての要素が格納されている配列
-
toString
public final String toString()このコレクションの文字列表現を返します。 文字列表現は、コレクションの要素の文字列表現をそのイテレータが返した順に角括弧("[]")で囲んだもので構成されます。 隣接する要素は、文字", "(カンマと空白文字)によって区切られます。 要素は、String.valueOf(Object)により文字列に変換されます。 -
containsAll
public final boolean containsAll(Collection<?> c)次のインタフェースからコピーされた説明:Collection指定されたコレクションのすべての要素がこのコレクション内にある場合はtrueを返します。- 定義:
- インタフェース
Collection<K>内のcontainsAll - パラメータ:
c- このコレクションにあるかどうかを調べるコレクション- 戻り値:
- 指定されたコレクションのすべての要素がこのコレクション内にある場合は
true - 関連項目:
Collection.contains(Object)
-
removeAll
public boolean removeAll(Collection<?> c)次のインタフェースからコピーされた説明:Collection指定されたコレクションにも格納されているこのコレクションのすべての要素を削除します(オプションの操作)。 この呼出しの結果、このコレクションには指定されたコレクションと共通の要素はなくなります。- 定義:
- インタフェース
Collection<K>内のremoveAll - パラメータ:
c- このコレクションから削除される要素を含むコレクション- 戻り値:
- 呼出しの結果としてこのコレクションが変更された場合は
true - 関連項目:
Collection.remove(Object),Collection.contains(Object)
-
retainAll
public final boolean retainAll(Collection<?> c)次のインタフェースからコピーされた説明:Collectionこのコレクションにおいて、指定されたコレクションに格納されている要素だけを保持します(オプションの操作)。 つまり、指定されたコレクションに格納されていないすべての要素をこのコレクションから削除します。- 定義:
- インタフェース
Collection<K>内のretainAll - パラメータ:
c- このコレクションで保持される要素を含むコレクション- 戻り値:
- 呼出しの結果としてこのコレクションが変更された場合は
true - 関連項目:
Collection.remove(Object),Collection.contains(Object)
-