EnumSet (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.util
クラス EnumSet<E extends Enum<E>>

java.lang.Object
  java.util.AbstractCollection<E>
      java.util.AbstractSet<E>
          java.util.EnumSet<E>

すべての実装されたインタフェース:: Serializable, Cloneable, Iterable<E>, Collection<E>, Set<E>

public abstract class EnumSet<E extends Enum<E>>
extends AbstractSet<E>
implements Cloneable, Serializable
extends AbstractSet<E>
implements Cloneable, Serializable

enum 型で使用するための特殊な Set 実装です。enum セット内の要素はすべて、セットの作成時に、指定された単一の enum 型から明示的または暗黙的に生成される必要があります。enum セットは、内部ではビットベクトルとして表現されます。この表現は、非常に簡潔かつ効率的です。このクラスの操作に必要な領域や時間は、従来の int ベースの「ビットフラグ」に対する高品質かつ型保証された代替として十分に使用可能です。引数も enum セットであれば、一括オペレーション (containsAll や retainAll など) でさえ非常に高速に実行できます。

iterator メソッドにより返される反復子は、要素を「自然順序」(enum 定数の宣言された順序) に従ってトラバースします。返される反復子は、「弱一貫性」を保持します。これらが ConcurrentModificationException をスローすることはありません。また、反復の進行中に実行されるセットへの変更の影響を表示することも、非表示にすることも可能です。

null 要素は許可されません。null 要素を挿入しようとすると、NullPointerException がスローされます。ただし、null 要素の存在をテストしたり、削除を試みる場合は正常に機能します。

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

Set<MyEnum> s = Collections.synchronizedSet(EnumSet.noneOf(MyEnum.class));

実装上の注意:基本のオペレーションはすべて一定時間に実行されます。これらは通常、HashSet の対応するオペレーションよりもずっと高速 (ただし保証外) に動作します。引数も enum セットであれば、一括オペレーションでさえ一定時間に実行されます。

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

導入されたバージョン:: 1.5
関連項目:: EnumMap

メソッドの概要

static



<E extends Enum<E>> 


EnumSet<E>

allOf(Class<E> elementType)
指定された要素型のすべての要素を含む enum セットを作成します。

EnumSet<E> clone()
このセットの複製を返します。

static



<E extends Enum<E>> 


EnumSet<E>

complementOf(EnumSet<E> s)
指定された enum セットと同じ要素型を使用して enum セットを作成します。

static



<E extends Enum<E>> 


EnumSet<E>

copyOf(Collection<E> c)
指定されたコレクションから初期化された enum セットを作成します。

static



<E extends Enum<E>> 


EnumSet<E>

copyOf(EnumSet<E> s)
指定された enum セットと同じ要素型を使用して、enum セットを作成します。

static



<E extends Enum<E>> 


EnumSet<E>

noneOf(Class<E> elementType)
指定された要素型を使用して空の enum セットを作成します。

static



<E extends Enum<E>> 


EnumSet<E>

of(E e)
指定された要素を最初に含む enum セットを作成します。

static



<E extends Enum<E>> 


EnumSet<E>

of(E first,
   E... rest)