|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
重複要素のないコレクションです。すなわち、セットは、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()
Collection
内の size
public boolean isEmpty()
Collection
内の isEmpty
public boolean contains(Object o)
(o==null ? e==null : o.equals(e))
に該当する要素 e
がある場合にだけ true を返します。Collection
内の contains
o
- セットにあるかどうかを調べる要素public Iterator iterator()
Collection
内の iterator
public Object[] toArray()
Collection
内の toArray
public Object[] toArray(Object[] a)
Collection
内の toArray
a
- セットの要素の格納先の配列。配列のサイズが十分でない場合は、同じ実行時の型で新しい配列が格納用として割り当てられるArrayStoreException
- a の実行時の型が、セット内の各要素の実行時の型のスーパータイプでない場合public boolean add(Object o)
(o==null ? e==null : o.equals(e))
に該当する要素 e
がなかった場合は、指定された要素 o
をセットに追加します。セット内にすでに指定された要素がある場合、呼び出しはセットを変更せずに false を返します。このため、コンストラクタについての制約との組み合わせにより、セットが重複要素を持たないことを保証します。
この規定は、セットがすべての要素を受け付けなければならないことを意味するわけではありません。つまり、セットでは、null を含む任意の要素の追加を拒否したり、例外をスローすることを任意に指定できます (Collection.add の仕様を参照)。セットの各実装では、セットが持つことのできる要素についての制約を明記するようにしてください。
Collection
内の add
o
- セットに追加される要素UnsupportedOperationException
- セットが add メソッドをサポートしていない場合ClassCastException
- 指定された要素のクラスのために、セットに要素を追加できない場合IllegalArgumentException
- この要素の一部の特性のために、このセットに追加できない場合public boolean remove(Object o)
(o==null ? e==null : o.equals(e))
に該当する要素 e
があった場合は、それを削除します。指定された要素がセット内にあった場合 (セットが呼び出しの結果として変更された場合) は、true を返します。呼び出しが復帰したあとは、セットは指定された要素を持っていません。Collection
内の remove
o
- セットにあれば削除されるオブジェクトUnsupportedOperationException
- セットが remove メソッドをサポートしていない場合public boolean containsAll(Collection c)
Collection
内の containsAll
c
- このセットにあるかどうかを調べるコレクションpublic boolean addAll(Collection c)
Collection
内の addAll
c
- 要素がセットに追加されるコレクションUnsupportedOperationException
- セットが addAll メソッドをサポートしていない場合ClassCastException
- 指定されたコレクションの要素のクラスが原因で、その要素をセットに追加できない場合IllegalArgumentException
- 指定されたコレクションの要素の特性が原因で、その要素をセットに追加できない場合add(Object)
public boolean retainAll(Collection c)
Collection
内の retainAll
c
- セットが保持する要素を定義するコレクションUnsupportedOperationException
- コレクションが retainAll メソッドをサポートしていない場合remove(Object)
public boolean removeAll(Collection c)
Collection
内の removeAll
c
- どの要素がセットから削除されるかを定義するコレクションUnsupportedOperationException
- このコレクションが removeAll メソッドをサポートしない場合remove(Object)
public void clear()
Collection
内の clear
UnsupportedOperationException
- セットが clear メソッドをサポートしていない場合public boolean equals(Object o)
Collection
内の equals
Object
内の equals
o
- このセットと等しいかどうかが比較される Objectpublic int hashCode()
s1
と s2
で s1.equals(s2)
の場合に s1.hashCode()==s2.hashCode()
になることが保証されます。Collection
内の hashCode
Object
内の hashCode
Object.hashCode()
,
Object.equals(Object)
,
equals(Object)
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.