java.util
クラス HashSet

java.lang.Object
  |
  +--java.util.AbstractCollection
        |
        +--java.util.AbstractSet
              |
              +--java.util.HashSet

すべての実装インタフェース:

Cloneable, Collection, Serializable, Set

public class HashSet

extends AbstractSet

implements Set, Cloneable, Serializable

このクラスは、ハッシュテーブル (実際には HashMap のインスタンス) を基にし、Set インタフェースを実装します。このクラスでは、セットの繰り返し順序について保証しません。特に、その順序を一定に保つことを保証しません。このクラスは、null 要素を許容します。

このクラスは、ハッシュ関数が複数のバケットで適切に要素を分散することを前提として、基本のオペレーション (add、remove、contains、および size) で一定時間の性能を提供します。セットの繰り返し処理では、HashSet のインスタンスのサイズ (要素数) と基となる HashMap のインスタンスの「容量」(バケット数) の合計に比例した時間が必要です。したがって、繰り返し処理の性能が重要な場合は、初期容量をあまり高く (負荷係数をあまり低く) 設定しないことが非常に重要です。

この実装は同期化されません。複数のスレッドが同時にセットにアクセスし、それらのスレッドの少なくとも 1 つがセットを変更する場合は、外部で同期をとる必要があります。通常、それはセットを自然にカプセル化するオブジェクトで同期をとることによって達成されます。そのようなオブジェクトがない場合には、Collections.synchronizedSet メソッドを使ってセットを「ラップ」します。これは、HashSet への偶発的な非同期アクセスを防ぐために、作成時に行うのが最適です。

     Set s = Collections.synchronizedSet(new HashSet(...));
 

このクラスの iterator メソッドによって返される反復子は「フェイルファスト」です。反復子が作成されたあとに、反復子独自の remove メソッド以外の方法でセットが変更された場合、反復子は ConcurrentModificationException をスローします。したがって、同時変更が行われると、反復子は、将来の予測できない時点において予測できない動作が発生する危険を回避するために、直ちにかつ手際よく例外をスローします。

導入されたバージョン:

1.2

関連項目:

Collection, Set, TreeSet, Collections.synchronizedSet(Set), HashMap, 直列化された形式

コンストラクタの概要

HashSet()
新しい空のセットを作成します。

HashSet(Collection c)
指定されたコレクションの要素を格納する新しいセットを作成します。

HashSet(int initialCapacity)
新しい空のセットを作成します。

HashSet(int initialCapacity, float loadFactor)
新しい空のセットを作成します。

メソッドの概要

boolean	add(Object o) 指定された要素がセットに存在していない場合に、その要素をセットに追加します。
void	clear() すべての要素をセットから削除します。
Object	clone() HashSet のインスタンスのシャローコピーを返します。
boolean	contains(Object o) セットが、指定された要素を保持している場合に true を返します。
boolean	isEmpty() セットが要素を 1 つも保持していない場合に true を返します。
Iterator	iterator() セットの要素の反復子を返します。
boolean	remove(Object o) 指定された要素があればセットから削除します。
int	size() セット内の要素数 (そのカーディナリティ) を返します。

クラス java.util.AbstractSet から継承したメソッド

equals, hashCode, removeAll

クラス java.util.AbstractCollection から継承したメソッド

addAll, containsAll, retainAll, toArray, toArray, toString

クラス java.lang.Object から継承したメソッド

finalize, getClass, notify, notifyAll, wait, wait, wait

インタフェース java.util.Set から継承したメソッド

addAll, containsAll, equals, hashCode, removeAll, retainAll, toArray, toArray

コンストラクタの詳細

HashSet

public HashSet()

新しい空のセットを作成します。基となる HashMap のインスタンスは、デフォルトの容量および負荷係数 (0.75) を持ちます。

HashSet

public HashSet(Collection c)

指定されたコレクションの要素を格納する新しいセットを作成します。基となる HashMap のインスタンスの容量は、指定されたコレクションのサイズの 2 倍または 11 (どちらか大きい方) であり、デフォルトの負荷係数 (0.75) が使用されます。

パラメータ:

c - 要素がセットに配置されるコレクション

HashSet

public HashSet(int initialCapacity,
               float loadFactor)

新しい空のセットを作成します。基となる HashMap のインスタンスは指定された初期容量および指定された負荷係数を持ちます。

パラメータ:

initialCapacity - ハッシュマップの初期容量

loadFactor - ハッシュマップの負荷係数

例外:

IllegalArgumentException - 初期容量が 0 より小さいか、負荷係数が正の値ではない場合

HashSet

public HashSet(int initialCapacity)

新しい空のセットを作成します。基となる HashMap のインスタンスは、指定された初期容量およびデフォルトの負荷係数 (0.75) を持ちます。

パラメータ:

initialCapacity - ハッシュテーブルの初期容量

例外:

IllegalArgumentException - 初期容量が 0 より小さい場合

メソッドの詳細

iterator

public Iterator iterator()

セットの要素の反復子を返します。要素が返されるときに特定の順序はありません。

定義:

インタフェース Set 内の iterator

オーバーライド:

クラス AbstractCollection 内の iterator

戻り値:

セットの要素の Iterator

関連項目:

ConcurrentModificationException

size

public int size()

セット内の要素数 (そのカーディナリティ) を返します。

定義:

インタフェース Set 内の size

オーバーライド:

クラス AbstractCollection 内の size

戻り値:

セット内の要素数 (そのカーディナリティ)

isEmpty

public boolean isEmpty()

セットが要素を 1 つも保持していない場合に true を返します。

定義:

インタフェース Set 内の isEmpty

オーバーライド:

クラス AbstractCollection 内の isEmpty

戻り値:

セットが要素を 1 つも保持していない場合は true

contains

public boolean contains(Object o)

セットが、指定された要素を保持している場合に true を返します。

定義:

インタフェース Set 内の contains

オーバーライド:

クラス AbstractCollection 内の contains

パラメータ:

o - セットにあるかどうかを調べる要素

戻り値:

セットが、指定された要素を保持している場合は true

add

public boolean add(Object o)

指定された要素がセットに存在していない場合に、その要素をセットに追加します。

定義:

インタフェース Set 内の add

オーバーライド:

クラス AbstractCollection 内の add

パラメータ:

o - セットに追加される要素

戻り値:

セットが指定された要素を保持していなかった場合は true

remove

public boolean remove(Object o)

指定された要素があればセットから削除します。

定義:

インタフェース Set 内の remove

オーバーライド:

クラス AbstractCollection 内の remove

パラメータ:

o - セットにあれば削除されるオブジェクト

戻り値:

指定された要素がセット内にあった場合は true

clear

public void clear()

すべての要素をセットから削除します。

定義:

インタフェース Set 内の clear

オーバーライド:

クラス AbstractCollection 内の clear

インタフェース java.util.Set からコピーされたタグ:

例外:

UnsupportedOperationException - セットが clear メソッドをサポートしていない場合

clone

public Object clone()

HashSet のインスタンスのシャローコピーを返します。要素自体は複製されません。

オーバーライド:

クラス Object 内の clone

戻り値:

このセットのシャローコピー