|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
重複要素のないコレクションです。すなわち、セットは、e1.equals(e2)
である e1
と e2
の要素ペアは持たず、null 要素を最大 1 つしか持ちません。その名前が示すように、このインタフェースは、数学で言う集合の抽象化をモデル化します。
Set インタフェースは、Collection インタフェースから継承した規定だけでなく、すべてのコンストラクタの規約、および add、equals、hashCode の各メソッドの規約に追加の規定を適用します。便宜上、ほかの継承メソッドの宣言もここに含まれます。これらの宣言に付随する仕様は Set インタフェースに合わせて調整済みですが、追加規定は含まれていません。
コンストラクタについての追加規定として、すべてのコンストラクタは、重複要素のないセットを作成しなければなりません (上記を参照)。
注: 可変オブジェクトがセット要素として使用される場合は、細心の注意が必要です。オブジェクトがセット内の要素であるうちに equals 比較に影響する方式でその値が変更された場合、セットの動作は保証されません。この禁止事項の特例により、セットがそれ自体を要素として持つことは許可されません。
Collection
,
List
,
SortedSet
,
HashSet
,
TreeSet
,
AbstractSet
,
Collections.singleton(java.lang.Object)
,
Collections.EMPTY_SET
メソッドの概要 | |
boolean |
add(Object o)
指定された要素がセット内になかった場合、セットに追加します (任意のオペレーション)。 |
boolean |
addAll(Collection c)
指定されたコレクションのすべての要素について、その要素がこのセット内にない場合、セットに追加します (任意のオペレーション)。 |
void |
clear()
セットからすべての要素を削除します (任意のオペレーション)。 |
boolean |
contains(Object o)
指定された要素がセット内にある場合に true を返します。 |
boolean |
containsAll(Collection c)
指定されたコレクションのすべての要素がセット内にある場合に true を返します。 |
boolean |
equals(Object o)
指定されたオブジェクトがセットと同じかどうかを比較します。 |
int |
hashCode()
セットのハッシュコード値を返します。 |
boolean |
isEmpty()
セットに要素が 1 つもない場合に true を返します。 |
Iterator |
iterator()
セット内の要素についての反復子を返します。 |
boolean |
remove(Object o)
指定された要素がセット内にあった場合、セットから削除します (任意のオペレーション)。 |
boolean |
removeAll(Collection c)
セットから、指定されたコレクション内にある要素をすべて削除します (任意のオペレーション)。 |
boolean |
retainAll(Collection c)
セット内の要素のうち、指定されたコレクション内にある要素だけを保持します (任意のオペレーション)。 |
int |
size()
セット内の要素数 (カーディナリティ) を返します。 |
Object[] |
toArray()
セット内のすべての要素が格納されている配列を返します。 |
Object[] |
toArray(Object[] a)
セット内のすべての要素が格納されている配列を返します。 |
メソッドの詳細 |
public int size()
public boolean isEmpty()
public boolean contains(Object o)
(o==null ? e==null : o.equals(e))
に該当する要素 e
がある場合にだけ true を返します。public Iterator iterator()
public Object[] toArray()
public Object[] toArray(Object[] a)
a
- 大きさが十分な場合は、セットの要素が格納されている配列。そうでない場合は、要素を格納するために同じ実行時の型の新しい配列が割り当てられるpublic boolean add(Object o)
(o==null ? e==null : o.equals(e))
に該当する要素 e
がなかった場合は、指定された要素 o
をセットに追加します。セット内にすでに指定された要素がある場合、呼び出しはセットを変更せずに false を返します。このため、コンストラクタについての制約との組み合わせにより、セットが重複要素を持たないことを保証します。
この規定は、セットがすべての要素を受け付けなければならないことを意味するわけではありません。つまり、セットでは、null を含む任意の要素の追加を拒否したり、例外をスローすることを任意に指定できます (Collection.add の仕様を参照)。セットの各実装では、セットが持つことのできる要素についての制約を明記するようにしてください。
o
- セットに追加される要素public boolean remove(Object o)
(o==null ? e==null : o.equals(e))
に該当する要素 e
があった場合は、それを削除します。指定された要素がセット内にあった場合 (セットが呼び出しの結果として変更された場合) は、true を返します。呼び出しが復帰したあとは、セットは指定された要素を持っていません。o
- セットにあった場合に削除されるオブジェクトpublic boolean containsAll(Collection c)
c
- セットにあるかどうかを判定されるコレクションpublic boolean addAll(Collection c)
c
- 要素がセットに追加されるコレクションadd(Object)
public boolean retainAll(Collection c)
c
- セットが保持する要素を定義するコレクションremove(Object)
public boolean removeAll(Collection c)
c
- セットから削除される要素を定義するコレクションremove(Object)
public void clear()
public boolean equals(Object o)
o
- セットと同じかどうかを比較される Objectpublic int hashCode()
s1
と s2
で s1.equals(s2)
の場合に s1.hashCode()==s2.hashCode()
になることが保証されます。Object.hashCode()
,
Object.equals(Object)
,
equals(Object)
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |