モジュール java.base

パッケージ java.util

クラスAbstractSet<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractSet<E>

型パラメータ:

E - このセットで保持される要素の型

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

Iterable<E>, Collection<E>, Set<E>

直系の既知のサブクラス:

ConcurrentSkipListSet, CopyOnWriteArraySet, EnumSet, HashSet, TreeSet

public abstract class AbstractSet<E> extends AbstractCollection<E> implements Set<E>

このクラスは、Setインタフェースのスケルトン実装を提供し、このインタフェースの実装に必要な作業を最小限に抑えます。

このクラスを拡張してセットを実装するプロセスは、AbstractCollectionを拡張してコレクションを実装するプロセスと同じです。ただし、このクラスのサブクラス内のすべてのメソッドおよびコンストラクタは、Setインタフェース(たとえば、addメソッドでは、オブジェクトの複数のインスタンスをセットに追加することはできません)によって課される追加の制約に従う必要があります。

このクラスは、AbstractCollectionクラスの実装をオーバーライドしないことに注意してください。 単に、equalsおよびhashCodeの実装を追加します。

このクラスは、Java Collections Frameworkのメンバーです。

導入されたバージョン:

1.2

関連項目:

• Collection
• AbstractCollection
• Set

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタ	説明
protected	AbstractSet()	唯一のコンストラクタです。

メソッドのサマリー

修飾子と型	メソッド	説明
boolean	equals(Object o)	指定されたオブジェクトがセットと同じかどうかを比較します。
int	hashCode()	セットのハッシュ・コード値を返します。
boolean	removeAll(Collection<?> c)	このセットから、指定されたコレクションに含まれる要素をすべて削除します(オプションの操作)。

クラスjava.util.AbstractCollectionで宣言されたメソッド

add, addAll, clear, contains, containsAll, isEmpty, iterator, remove, retainAll, toArray, toArray, toString

クラスjava.lang.Objectで宣言されたメソッド

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

インタフェースjava.util.Collectionで宣言されたメソッド

parallelStream, removeIf, stream, toArray

インタフェースjava.lang.Iterableで宣言されたメソッド

forEach

インタフェースjava.util.Setで宣言されたメソッド

add, addAll, clear, contains, containsAll, isEmpty, iterator, remove, retainAll, size, spliterator, toArray, toArray

コンストラクタの詳細

AbstractSet

protected AbstractSet()

唯一のコンストラクタです。 (サブクラスのコンストラクタによる呼出し用で、通常は暗黙的に呼び出されます。)

メソッドの詳細

equals

public boolean equals(Object o)

指定されたオブジェクトがセットと同じかどうかを比較します。 指定されたオブジェクトもセットで、2つのセットが同じサイズで、指定されたセットのすべてのメンバーがこのセットに含まれている場合は、trueを返します。 これにより、equalsメソッドがSetインタフェースのさまざまな実装間で正しく動作することが保証されます。

この実装では、最初に指定されたオブジェクトがこのセットであるかどうかをチェックします。その場合は、trueを返します。 次に、指定されたオブジェクトについて、このセットと同じサイズのセットであるかどうかを調べます。指定されたオブジェクトがこのセットと同じサイズのセットではない場合はfalseを返します。 その場合、containsAll((Collection) o)が返されます。

定義:

equals、インタフェースCollection<E>

定義:

equals、インタフェースSet<E>

オーバーライド:

equals、クラスObject

パラメータ:

o - このセットと等しいかどうかが比較されるオブジェクト

戻り値:

指定されたオブジェクトがこのセットに等しい場合はtrue

関連項目:

• Object.equals(Object)
• Set.equals(Object)
• List.equals(Object)

hashCode

public int hashCode()

セットのハッシュ・コード値を返します。 セットのハッシュ・コードは、セット内の要素のハッシュ・コードの合計として定義されます。ここで、null要素のハッシュ・コードはゼロとして定義されます。 これにより、s1.equals(s2)は、Object.hashCode()の一般契約で要求されるように、s1およびs2の2つのセットに対してs1.hashCode()==s2.hashCode()が暗黙的に指定されます。

この実装は、セットに対して反復処理を行い、セット内の各要素に対してhashCodeメソッドをコールして結果を追加します。

定義:

hashCode、インタフェースCollection<E>

定義:

hashCode、インタフェースSet<E>

オーバーライド:

hashCode、クラスObject

戻り値:

セットのハッシュ・コード値

関連項目:

• Object.equals(Object)
• Set.equals(Object)

removeAll

public boolean removeAll(Collection<?> c)

このセットから、指定されたコレクションに含まれる要素をすべて削除します(オプションの操作)。 指定されたコレクションもセットである場合、このオペレーションは、その値が2つのセットの非対称集合差分になるようにこのセットを効率的に変更します。

この実装では、それぞれに対してsizeメソッドを呼び出して、このセットと指定されたコレクションのどちらが小さいかを判断します。 このセットの要素の方が少ない場合、実装はこのセットのイテレータが返す順に各要素が指定されたコレクション内に含まれるかどうかを確認します。 含まれている場合は、イテレータのremoveメソッドを使用してこのセットから削除されます。 指定したコレクションの要素が少ない場合、実装では、このセットのremoveメソッドを使用して、このセットからイテレータによって返される各要素を削除します。

iteratorメソッドから返されたイテレータがremoveメソッドを実装していない場合、この実装はUnsupportedOperationExceptionをスローすることに注意してください。

定義:

removeAll、インタフェースCollection<E>

定義:

removeAll、インタフェースSet<E>

オーバーライド:

removeAll、クラスAbstractCollection<E>

パラメータ:

c - このセットから削除される要素を含むコレクション

戻り値:

呼出しの結果としてこのセットが変更された場合はtrue

例外:

UnsupportedOperationException - removeAll操作がこのセットでサポートされていない場合

ClassCastException - このセットのある要素のクラスが、指定されたコレクションと互換でない場合(オプション)

NullPointerException - このセットにnull要素が含まれており、指定されたコレクションがnull要素を許可しない場合(オプション)、または指定されたコレクションがnullの場合

関連項目:

• AbstractCollection.remove(Object)
• AbstractCollection.contains(Object)