🔥 Breaking News: javase/jp//docs/api/java/util/Set.html

型パラメータ:

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

すべてのスーパー・インタフェース:

Collection<E>, Iterable<E>

既知のすべてのサブインタフェース:

NavigableSet<E>, SortedSet<E>

既知のすべての実装クラス:

AbstractSet, ConcurrentHashMap.KeySetView, ConcurrentSkipListSet, CopyOnWriteArraySet, EnumSet, HashSet, JobStateReasons, LinkedHashSet, TreeSet
```
public interface Set<E>
extends Collection<E>
```
重複要素のないコレクションです。すなわち、セットは、e1.equals(e2)であるe1とe2の要素ペアは持たず、null要素を最大1つしか持ちません。その名前が示すように、このインタフェースは、数学で言う集合の抽象化をモデル化します。
Setインタフェースは、Collectionインタフェースから継承した規定だけでなく、すべてのコンストラクタの規約、およびadd、equals、hashCodeの各メソッドの規約に追加の規定を適用します。便宜上、ほかの継承メソッドの宣言もここに含まれます。これらの宣言に付随する仕様はSetインタフェースに合わせて調整済みですが、追加規定は含まれていません。
コンストラクタについての追加規定として、すべてのコンストラクタは、重複要素のないセットを作成しなければなりません(上記を参照)。
ノート: 可変オブジェクトがセット要素として使用される場合は、細心の注意が必要です。オブジェクトがセット内の要素であるときに、equalsの比較に影響を与える方法でオブジェクトの値が変更された場合、セットの動作は保証されません。この禁止事項の特例により、セットがそれ自体を要素として持つことは許可されません。
セットの実装には、格納できる要素に制限があるものもあります。たとえば、null要素を禁止する実装や、null要素の型に制限がある実装もあります。不適格な要素を追加しようとすると、通常NullPointerExceptionまたはClassCastExceptionのような非チェック例外がスローされます。不適格な要素を照会しようとすると、例外がスローされる場合や、ただfalseを返す場合もあります。前者の動作を実行する実装もあれば、後者の動作を実行する実装もあります。もう少し一般的に言うと、セットへの挿入がされない不適当な要素を処理しようとすると、例外がスローされる場合や、処理が有効になる場合があります。このインタフェースの仕様では、そうした例外は「任意」と記載されています。
このインタフェースは、Java Collections Frameworkのメンバーです。

導入されたバージョン:

1.2

関連項目:

Collection, List, SortedSet, HashSet, TreeSet, AbstractSet, Collections.singleton(java.lang.Object), Collections.EMPTY_SET

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッドデフォルト・メソッド
修飾子と型	メソッド	説明
`boolean`	`add(E e)`	指定された要素がセット内になかった場合、セットに追加します(オプションの操作)。
`boolean`	`addAll(Collection<? extends E> c)`	指定されたコレクションのすべての要素について、その要素がこのセット内にない場合、セットに追加します(オプションの操作)。
`void`	`clear()`	セットからすべての要素を削除します(オプションの操作)。
`boolean`	`contains(Object o)`	指定された要素がセットに含まれている場合に`true`を返します。
`boolean`	`containsAll(Collection<?> c)`	指定されたコレクションのすべての要素がこのセットに含まれている場合に`true`を返します。
`boolean`	`equals(Object o)`	指定されたオブジェクトがセットと同じかどうかを比較します。
`int`	`hashCode()`	セットのハッシュ・コード値を返します。
`boolean`	`isEmpty()`	このセットに要素が1つも含まれていない場合に`true`を返します。
`Iterator<E>`	`iterator()`	セット内の各要素についてのイテレータを返します。
`boolean`	`remove(Object o)`	指定された要素がセット内にあった場合、セットから削除します(オプションの操作)。
`boolean`	`removeAll(Collection<?> c)`	このセットから、指定されたコレクションに含まれる要素をすべて削除します(オプションの操作)。
`boolean`	`retainAll(Collection<?> c)`	セット内の要素のうち、指定されたコレクション内にある要素だけを保持します(オプションの操作)。
`int`	`size()`	セット内の要素数(そのカーディナリティ)を返します。
`default Spliterator<E>`	`spliterator()`	このセット内の要素に対する`Spliterator`を作成します。
`Object[]`	`toArray()`	セット内のすべての要素が格納されている配列を返します。
`<T> T[]`	`toArray(T[] a)`	セット内のすべての要素を格納している配列を返します。返される配列の実行時の型は、指定された配列の型になります。

インタフェース java.util.Collectionから継承されたメソッド
parallelStream, removeIf, stream

インタフェースjava.lang.Iterableから継承されたメソッド
forEach

- メソッドの詳細
  - size
```
int size()
```
    セット内の要素数(そのカーディナリティ)を返します。このセットにInteger.MAX_VALUEより多くの要素がある場合は、Integer.MAX_VALUEを返します。
    
    定義:
    
    size、インタフェースCollection<E>
    
    戻り値:
    
    セット内の要素数(そのカーディナリティ)
  - isEmpty
```
boolean isEmpty()
```
    このセットに要素が1つも含まれていない場合にtrueを返します。
    
    定義:
    
    isEmpty、インタフェースCollection<E>
    
    戻り値:
    
    このセットに要素が1つも含まれていない場合はtrue
  - contains
```
boolean contains(Object o)
```
    指定された要素がセットに含まれている場合にtrueを返します。つまり、このセットに、(o==null ? e==null : o.equals(e))となる要素eが含まれている場合にのみtrueを返します。
    
    定義:
    
    contains、インタフェースCollection<E>
    
    パラメータ:
    
    o - このセット内にあるかどうかが判定される要素
    
    戻り値:
    
    指定された要素がこのセットに含まれている場合はtrue
    
    例外:
    
    ClassCastException - 指定された要素の型が、このセットと互換でない場合(オプション)
    
    NullPointerException - 指定された要素がnullで、このセットがnull要素を許可しない場合(オプション)
  - iterator
```
Iterator<E> iterator()
```
    セット内の各要素についてのイテレータを返します。セットが順序を保証する特定クラスのインスタンスでないかぎり、要素は特定の順序では返されません。
    
    定義:
    
    iterator、インタフェースCollection<E>
    
    定義:
    
    iterator、インタフェースIterable<E>
    
    戻り値:
    
    セットの要素のイテレータ
  - toArray
```
Object[] toArray()
```
    セット内のすべての要素が格納されている配列を返します。イテレータによって要素が返される順序をセットが保証する場合、このメソッドは同じ順序で要素を返さなければいけません。
    返される配列への参照をセットが維持しないという点で、この配列は安全です。つまり、このメソッドは、セットが配列に連動している場合でも新しい配列を割り当てます。このため、呼出し側は、返された配列を自由に変更できます。
    このメソッドは、配列ベースのAPIとコレクションベースのAPIの間の橋渡し役として機能します。
    
    定義:
    
    toArray、インタフェースCollection<E>
    
    戻り値:
    
    セット内のすべての要素を保持している配列
  - toArray
```
<T> T[] toArray(T[] a)
```
    セット内のすべての要素を格納している配列を返します。返される配列の実行時の型は、指定された配列の型になります。セットが指定された配列に収まる場合は、その中に返されます。そうでない場合は、指定された配列の実行時の型とセットのサイズを持つ新しい配列が割り当てられます。
    このセットが指定された配列に収まり、その配列にさらに余裕がある場合(つまり、配列がセットより多くの要素を持つ場合)、その配列内でセットの終端よりあとの要素はnullに設定されます。このセットにnull要素がないことを呼出し側が知っている場合にだけ、この特性を利用してこのセットの長さを判断できます。
    イテレータによって要素が返される順序をセットが保証する場合、このメソッドは同じ順序で要素を返さなければいけません。
    toArray()メソッドと同じように、このメソッドは、配列ベースのAPIとコレクションベースのAPIの間の橋渡し役として機能します。さらに、このメソッドでは出力配列の実行時の型を正確に制御できるため、環境によっては割当ての手間を抑えるために使用できます。
    xが、文字列だけからなるセットであることがわかっていると仮定します。次のコードを使うと、新しく割り当てられたStringの配列内にセットをダンプできます。
```
     String[] y = x.toArray(new String[0]);
```
    toArray(new Object[0])は、機能の点でtoArray()と同一です。
    定義:
    
    toArray、インタフェースCollection<E>
    
    型パラメータ:
    
    T - コレクションを含む配列の実行時の型
    
    パラメータ:
    
    a - 配列が十分な大きさを持つ場合は、このセットの要素の格納先の配列。配列のサイズが十分でない場合は、同じ実行時の型で新しい配列が格納用として割り当てられる。
    
    戻り値:
    
    セット内のすべての要素を保持している配列
    
    例外:
    
    ArrayStoreException - 指定された配列の実行時の型が、このセット内のすべての要素の実行時の型のスーパー・タイプでない場合
    
    NullPointerException - 指定された配列がnullである場合
  - add
```
boolean add(E e)
```
    指定された要素がセット内になかった場合、セットに追加します(オプションの操作)。つまり、セット内に、(e==null ? e2==null : e.equals(e2))となる要素e2がない場合は、指定された要素eをこのセットに追加します。このセット内にすでにその要素が含まれている場合、この呼出しではセットを変更せずにfalseを返します。このため、コンストラクタについての制約との組み合わせにより、セットが重複要素を持たないことを保証します。
    この規定は、セットがすべての要素を受け付ける必要があることを意味するわけではありません。セットは、nullを含む特定の要素の追加を拒否して例外をスローできます(Collection.addの仕様を参照)。セットの各実装では、セットが持つことのできる要素についての制約を明記するようにしてください。
    
    定義:
    
    add、インタフェースCollection<E>
    
    パラメータ:
    
    e - このセットに追加される要素
    
    戻り値:
    
    このセット内に、指定された要素がなかった場合はtrue
    
    例外:
    
    UnsupportedOperationException - addオペレーションがこのセットでサポートされない場合
    
    ClassCastException - 指定された要素のクラスが原因で、このセットにその要素を追加できない場合
    
    NullPointerException - 指定された要素がnullであり、このセットがnull要素を許可しない場合
    
    IllegalArgumentException - 指定された要素のあるプロパティが原因で、このセットにその要素を追加できない場合
  - remove
```
boolean remove(Object o)
```
    指定された要素がセット内にあった場合、セットから削除します(オプションの操作)。つまり、このセット内に、(o==null ? e==null : o.equals(e))となる要素eが含まれている場合は、そのような要素を削除します。その要素がこのセットに含まれていた場合、つまり、呼出しの結果としてこのセットが変更された場合はtrueを返します。呼出しが復帰したあとは、このセットはその要素を持っていません。
    
    定義:
    
    remove、インタフェースCollection<E>
    
    パラメータ:
    
    o - このセットから削除されるオブジェクト(そのオブジェクトが存在する場合)
    
    戻り値:
    
    セットが、指定された要素を保持していた場合はtrue
    
    例外:
    
    ClassCastException - 指定された要素の型が、このセットと互換でない場合(オプション)
    
    NullPointerException - 指定された要素がnullで、このセットがnull要素を許可しない場合(オプション)
    
    UnsupportedOperationException - removeオペレーションがこのセットでサポートされない場合
  - containsAll
```
boolean containsAll(Collection<?> c)
```
    指定されたコレクションのすべての要素がこのセットに含まれている場合にtrueを返します。指定されたコレクションもセットである場合、指定されたセットがこのセットのサブセットであれば、このメソッドはtrueを返します。
    
    定義:
    
    containsAll、インタフェースCollection<E>
    
    パラメータ:
    
    c - このセットに含まれているかどうかがチェックされるコレクション
    
    戻り値:
    
    指定されたコレクションのすべての要素がこのセットに含まれている場合はtrue
    
    例外:
    
    ClassCastException - 指定されたコレクションの1つ以上の要素の型が、セットと互換でない場合(オプション)
    
    NullPointerException - 指定されたコレクションに1つ以上のnull要素が含まれており、このセットがnull要素を許可しない場合(オプション)、または指定されたコレクションがnullの場合
    
    関連項目:
    
    contains(Object)
  - addAll
```
boolean addAll(Collection<? extends E> c)
```
    指定されたコレクションのすべての要素について、その要素がこのセット内にない場合、セットに追加します(オプションの操作)。指定されたコレクションもセットである場合、addAllオペレーションは、その値が2つのセットの和集合になるようにこのセットを効率的に変更します。オペレーションの進行中に指定されたコレクションが変更された場合の、このオペレーションの動作は定義されていません。
    
    定義:
    
    addAll、インタフェースCollection<E>
    
    パラメータ:
    
    c - このセットに追加される要素を含むコレクション
    
    戻り値:
    
    呼出しの結果としてこのセットが変更された場合はtrue
    
    例外:
    
    UnsupportedOperationException - addAllオペレーションがこのセットでサポートされない場合
    
    ClassCastException - 指定されたコレクションの要素のクラスが原因で、このセットにその要素を追加できない場合
    
    NullPointerException - 指定されたコレクションに1つ以上のnull要素が含まれており、このセットがnull要素を許可しない場合、または指定されたコレクションがnullの場合
    
    IllegalArgumentException - 指定されたコレクションの要素のあるプロパティが原因で、このセットにその要素を追加できない場合
    
    関連項目:
    
    add(Object)
  - retainAll
```
boolean retainAll(Collection<?> c)
```
    セット内の要素のうち、指定されたコレクション内にある要素だけを保持します(オプションの操作)。つまり、セットから、指定されたコレクション内にない要素をすべて削除します。指定されたコレクションもセットである場合、このオペレーションは、その値が2つのセットの共通部分になるようにこのセットを効率的に変更します。
    
    定義:
    
    retainAll、インタフェースCollection<E>
    
    パラメータ:
    
    c - このセットで保持される要素を含むコレクション
    
    戻り値:
    
    呼出しの結果としてこのセットが変更された場合はtrue
    
    例外:
    
    UnsupportedOperationException - retainAllオペレーションがこのセットでサポートされない場合
    
    ClassCastException - このセットのある要素のクラスが、指定されたコレクションと互換でない場合(オプション)
    
    NullPointerException - このセットにnull要素が含まれており、指定されたコレクションがnull要素を許可しない場合(オプション)、または指定されたコレクションがnullの場合
    
    関連項目:
    
    remove(Object)
  - removeAll
```
boolean removeAll(Collection<?> c)
```
    このセットから、指定されたコレクションに含まれる要素をすべて削除します(オプションの操作)。指定されたコレクションもセットである場合、このオペレーションは、その値が2つのセットの非対称集合差分になるようにこのセットを効率的に変更します。
    
    定義:
    
    removeAll、インタフェースCollection<E>
    
    パラメータ:
    
    c - このセットから削除される要素を含むコレクション
    
    戻り値:
    
    呼出しの結果としてこのセットが変更された場合はtrue
    
    例外:
    
    UnsupportedOperationException - removeAllオペレーションがこのセットでサポートされない場合
    
    ClassCastException - このセットのある要素のクラスが、指定されたコレクションと互換でない場合(オプション)
    
    NullPointerException - このセットにnull要素が含まれており、指定されたコレクションがnull要素を許可しない場合(オプション)、または指定されたコレクションがnullの場合
    
    関連項目:
    
    remove(Object), contains(Object)
  - clear
```
void clear()
```
    セットからすべての要素を削除します(オプションの操作)。この呼出しが戻ると、セットは空になります。
    
    定義:
    
    clear、インタフェースCollection<E>
    
    例外:
    
    UnsupportedOperationException - clearメソッドがこのセットでサポートされない場合
  - equals
```
boolean equals(Object o)
```
    指定されたオブジェクトがセットと同じかどうかを比較します。指定されたオブジェクトもセットで、2つのセットが同じサイズを持ち、指定されたセットのすべてのメンバーがこのセットに含まれる場合(つまり、このセットのすべてのメンバーが指定されたセットに含まれる場合)にtrueを返します。この定義により、equalsメソッドがセット・インタフェースのさまざまな実装で適切に動作することが保証されます。
    
    定義:
    
    equals、インタフェースCollection<E>
    
    オーバーライド:
    
    equals、クラスObject
    
    パラメータ:
    
    o - このセットと等しいかどうかが比較されるオブジェクト
    
    戻り値:
    
    指定されたオブジェクトがこのセットと等しい場合はtrue
    
    関連項目:
    
    Object.hashCode()、HashMap
  - hashCode
```
int hashCode()
```
    セットのハッシュ・コード値を返します。セットのハッシュ・コードは、そのセット内の要素のハッシュ・コードの合計になるように定義されています。ただし、null要素のハッシュ・コードはゼロになるように定義されています。これにより、Object.hashCode()の一般規約によって要求されるように、任意の2つのセットs1とs2でs1.equals(s2)であれば、s1.hashCode()==s2.hashCode()となることが保証されます。
    
    定義:
    
    hashCode、インタフェースCollection<E>
    
    オーバーライド:
    
    hashCode、クラスObject
    
    戻り値:
    
    セットのハッシュ・コード値
    
    関連項目:
    
    Object.equals(Object), equals(Object)
  - spliterator
```
default Spliterator<E> spliterator()
```
    このセット内の要素に対するSpliteratorを作成します。
    SpliteratorはSpliterator.DISTINCTを報告します。実装は、追加の特性値の報告をドキュメント化する必要があります。
    
    定義:
    
    spliterator、インタフェースCollection<E>
    
    定義:
    
    spliterator、インタフェースIterable<E>
    
    実装要件:
    
    デフォルト実装は、セットのIteratorから遅延バインディング・スプリッテレータを作成します。スプリッテレータは、セットのイテレータのフェイルファスト・プロパティを継承します。
    作成されたSpliteratorは、追加でSpliterator.SIZEDを報告します。
    
    実装上のノート:
    
    作成されたSpliteratorはさらにSpliterator.SUBSIZEDも報告します。
    
    戻り値:
    
    このセット内の要素に対するSpliterator
    
    導入されたバージョン:
    
    1.8

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

インタフェースSet<E>

メソッドのサマリー

インタフェース java.util.Collectionから継承されたメソッド

インタフェースjava.lang.Iterableから継承されたメソッド

メソッドの詳細

size

isEmpty

contains

iterator

toArray

toArray

add

remove

containsAll

addAll

retainAll

removeAll

clear

equals

hashCode

spliterator