インタフェースCollection<E>

型パラメータ:
E - このコレクションの要 のタイプ
すべてのスーパー・インタフェース:
Iterable<E>
既知のすべてのサブインタフェース:
BeanContext, BeanContextServices, BlockingDeque<E>, BlockingQueue<E>, Deque<E>, EventSet, List<E>, NavigableSet<E>, Queue<E>, SequencedCollection<E>, SequencedSet<E>, Set<E>, SortedSet<E>, TransferQueue<E>
既知のすべての実装クラス:
AbstractCollection, AbstractList, AbstractQueue, AbstractSequentialList, AbstractSet, ArrayBlockingQueue, ArrayDeque, ArrayList, AttributeList, BeanContextServicesSupport, BeanContextSupport, ConcurrentHashMap.KeySetView, ConcurrentLinkedDeque, ConcurrentLinkedQueue, ConcurrentSkipListSet, CopyOnWriteArrayList, CopyOnWriteArraySet, DelayQueue, EnumSet, HashSet, JobStateReasons, LinkedBlockingDeque, LinkedBlockingQueue, LinkedHashSet, LinkedList, LinkedTransferQueue, PriorityBlockingQueue, PriorityQueue, RoleList, RoleUnresolvedList, Stack, SynchronousQueue, TreeSet, Vector
public interface Collection<E> extends Iterable<E>
コレクション階層のルート・インタフェースです。 コレクションは、その要 であるオブジェクトのグループを表します。 コレクションによっては要 の重複を許可しますが、許可しないコレクションもあります。 オーダーされたものもあれば、オーダーされなかったものもあります。 「見つける」が定義されているコレクションは、通常、SequencedCollectionインタフェースのサブタイプです。 JDKでは、このインタフェースのdirect実装は提供されません: SetやListなど、より具体的なサブインタフェースの実装を提供します。 このインタフェースは、通常は、最大限の普遍性が求められる 面でコレクションを渡したり、そのコレクションを操作するために使用されます。

Bagまたはマルチセット (重複要 を 納できる、 序付けのないコレクション)は、このインタフェースを直接実装する必要があります。

すべての汎用Collection実装クラス(通常、サブインタフェースの1つを介してCollectionを間接的に実装)は、2つの"standard"コンストラクタを提供する必要があります: 空のコレクションを作成するvoid (引数なし)コンストラクタと、引数と同じ要 を持つ新しいコレクションを作成するCollection型の単一の引数を持つコンストラクタ。 したがって、後者のコンストラクタでは、ユーザーはどのコレクションでもコピーでき、希望の実装型のコレクションと完全に同じコレクションを生成できます。 この規則(インタフェースにコンストラクタを含めることができないため)を強制する方法はありませんが、Javaプラットフォー ・ライブラリのすべての汎用Collection実装が準 しています。

特定のメソッドは、optionalとして指定されます。 コレクション実装が特定の操作を実装しない 合、対応するメソッドを定義してUnsupportedOperationExceptionをスローする必要があります。 このようなメソッドは、コレクション・インタフェースのメソッド仕様に"オプションの操作"とマークされています。

いくつかのコレクション実装には、要 に含まれる可能性のある制限があります。 たとえば、null要 を禁止する実装や、null要 の型に制限がある実装もあります。 不適 要 を追 しようとすると、チェックされていない例外(通常はNullPointerExceptionまたはClassCastException)がスローされます。 不適 な要 を照会しようとすると、例外がスローされる 合や、た falseを返す 合もあります。前者の動作を実行する実装もあれば、後者の動作を実行する実装もあります。 ほとんどの 合、処理が完了しても不適 な要 のコレクションへの挿入が発生しないような不適 な要 の処理を試みると、実装のオプションに応じて例外がスローされるか、または正常に終了します。 このインタフェースの仕様では、そうした例外は「任意」と記載されています。

独自の同期ポリシーを決定するかどうかは、それぞれのコレクションによって異なります。 実装による強い保証がない 合、別のスレッドによって変更されるコレクションでメソッドを呼び出すと、定義されていない動作が発生する可能性があります。これには、直接の呼び出し、呼出しを実行する可能性があるメソッドへのコレクションの引渡し、および既存のイテレータを使用したコレクションの検査が含まれます。

Collections Frameworkインタフェース内の多数のメソッドは、equalsメソッドとの関連で定義されます。 たとえば、contains(Object o)メソッドの指定では次のようになります : "このコレクションに(o==null ? e==null : o.equals(e))のような要 eが少なくとも1つ含まれている 合のみ、trueを返します。" この指定は、null以外の引数oを指定してCollection.containsを呼び出すと、要 eに対してo.equals(e)が呼び出されることを意味するように解釈しないでく さい。 実装は、2つの要 のハッシュ・コードを最初に比較するなどして、equalsの呼出しを回避する最適化を自由に実装できます。 (Object.hashCode()仕様では、等価ではないハッシュ・コードを保持する2つのオブジェクトは等価ではないことが保証されます。) もう少し一般的に言うと、さまざまなCollections Frameworkインタフェースの実装で、実装者が適切と判断するなら、基本となるObjectメソッドの指定された動作を自由に利用できます。

コレクションの再帰的なトラバーサルを行うコレクション操作の中には、コレクションにそれ自身が直接または間接的に含まれる自己参照型インスタンスの例外によって失敗するものがあります。 これには、clone()、equals()、hashCode()、およびtoString()メソッドが含まれます。 実装ではオプションで自己参照シナリオを処理できますが、最新の実装では行われていません。

コレクションを表示

ほとんどのコレクションでは、 納されている要 のストレージが管理されます。 対照的に、「コレクションを表示」自体は要 を 納しませんが、実際の要 を 納するためにバッキング・コレクションに依存します。 ビュー・コレクション自体で処理されない操作は、バッキング・コレクションに委任されます。 ビュー・コレクションの例には、Collections.checkedCollection、Collections.synchronizedCollection、Collections.unmodifiableCollectionなどのメソッドによって返されるラッパー・コレクションがあります。 ビュー・コレクションのその他の例には、List.subList、NavigableSet.subSet、Map.entrySet、SequencedCollection.reversedなど、同じ要 の異なる表現を提供するコレクションがあります。 バッキング・コレクションに えられたすべての変更は、ビュー・コレクションに表示されます。 これに対応して、ビュー・コレクションに えられた変更 - 変更が許可されている 合 - バッキング・コレクションに書き込まれます。 これらは技術的にはコレクションではありませんが、IteratorおよびListIteratorのインスタンスでは、バッキング・コレクションへの変更の書込みも許可され、 合によっては反復中にバッキング・コレクションへの変更が表示されることがあります。

変更不可能なコレクション

このインタフェースの特定のメソッドは"destructive"とみなされ、"mutator"メソッドと呼ばれ、操作対象のコレクション内に含まれるオブジェクトのグループを変更します。 このコレクションの実装が操作をサポートしていない 合、UnsupportedOperationExceptionをスローするように指定することができます。 そのようなメソッドは、呼び出しがコレクションに影響を与えない 合、UnsupportedOperationExceptionをスローする必要があります。 たとえば、add操作をサポートしていないコレクションを考えてみましょう。 addAllメソッドがこのコレクションで呼び出され、引数として空のコレクションがある 合はどうなりますか? ゼロ要 の追 は効果がないため、このコレクションでは何もしないで例外をスローすることはできません。 た し、このような 合は、例外をスローすると無条件に例外がスローされることが推奨されます。

「変更不可能なコレクション」はコレクションであり、すべてのメソッド(上で定義したように)がUnsupportedOperationExceptionをスローするように指定されています。 したがって、そのようなコレクションは、その上の任意のメソッドを呼び出すことによって変更することはできません。 コレクションを適切に変更できないようにするには、コレクションから派生したビュー・コレクションも変更不可能でなければなりません。 たとえば、Listを変更できない 合、List.subListによって返されたListも変更不可能です。

変更不可能なコレクションは必ずしも変更できません。 含まれている要 が変更可能な 合、コレクション全体が変更不可能であっても、明らかに変更可能です。 たとえば、変更可能な要 を含む2つの変更不可能なリストを考えてみましょう。 両方のリストが変更不可能であっても、要 が変更された 合、list1.equals(list2)を呼び出した結果は、呼び出しごとに異なる 合があります。 た し、変更不能なコレクションにすべての変更不能な要 が含まれている 合は、効果的に不変であると見なすことができます。

変更不可能なビュー・コレクション

「変更不可能なビュー・コレクション」は変更不可能なコレクションで、バッキング・コレクションのビューです。 そのメソッドは上記のようにUnsupportedOperationExceptionをスローしますが、読み込みメソッドと問合せメソッドはバッキング・コレクションに委譲されます。 その効果は、バッキング・コレクションへの読み取り専用アクセスを提供することです。 これは、内部コレクションへの読み取りアクセスをユーザーに提供し、そのコレクションが予期せず変更されるのを防ぐために役立ちます。 変更不可能なビュー・コレクションの例として、Collections.unmodifiableCollection、Collections.unmodifiableListおよび関連するメソッドによって返されるものがあります。

バッキング・コレクションへの変更は引き続き可能であり、変更が発生した 合は変更不可能なビューで表示されることに注意してく さい。 したがって、変更不可能なビュー・コレクションは必ずしも不変であるとは限りません。 た し、変更不可能なビューのバッキング・コレクションが効果的に不変である 合、またはバッキング・コレクションへの参照が変更不可能なビューのみである 合、ビューは効果的に不変であるとみなすことができます。

コレクションの直列化可能性

コレクションの直列化可能性はオプションです。 このため、どのコレクション・インタフェースもSerializableインタフェースを実装するように宣言されていません。 た し、直列化可能性は一般に有用と考えられるため、ほとんどの収集実装は直列化可能です。

(ArrayListまたはHashMapなどの)のパブリック・クラスであるコレクション実装は、実際に直列化可能なSerializableインタフェースを実装するように宣言されています。 一部のコレクション実装は、「変更不可能なコレクション」などのパブリック・クラスではありません。 このような 合、このようなコレクションの直列化可能性については、そのコレクションを作成するメソッドの指定またはその他の適切な 所で説明されています。 コレクションの直列化可能性が指定されていない 合、このような収集の直列化可能性に関する保証はありません。 特に、元のコレクションが直列化可能であっても、多くの「コレクションを表示」は直列化可能ではありません。

Serializableインタフェースを実装するコレクション実装は、直列化可能であることを保証できません。 その理由は、コレクションには他の型の要 が含まれているため、一部の要 型のインスタンスが実際に直列化可能かどうかを静的に判断できないためです。 たとえば、EがSerializableインタフェースを実装していない直列化可能なCollection<E>について考えてみます。 コレクションは、Eの直列化可能なサブタイプの要 のみが含まれている 合、または空の 合は、直列化可能です。 このため、コレクションは、コレクション全体の直列化可能性として「条件付きで直列化可能」と言われています。これは、コレクション自体が直列化可能かどうか、および含まれるすべての要 も直列化可能かどうかによって異なります。

SortedSetおよびSortedMapのインスタンスでは追 のケースが発生します。 これらのコレクションは、セット要 またはマップ・キーに 序付けを行うComparatorを使用して作成できます。 そのようなコレクションは、Comparatorが直列化可能である 合にのみ直列化可能です。

このインタフェースは、Java Collections Frameworkのメンバーです。

実装要件:
デフォルトのメソッド実装(継承または別の方法によるもの)は、同期プロトコルを適用しません。 Collectionの実装に特定の同期プロトコルが含まれている 合は、デフォルトの実装をオーバーライドしてそのプロトコルを適用する必要があります。
導入されたバージョン:
1.2
関連 目:

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    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()
    このコレクションに要 がない 合にtrueを返します。
    Iterator<E>
    iterator()
    コレクションの要 のイテレータを返します。
    default Stream<E>
    parallelStream()
    このコレクションをソースとして、潜在的に並列のStreamを返します。
    boolean
    remove(Object o)
    指定された要 のインスタンスがこのコレクションにあれば、そのインスタンスをコレクションから1つ削除します(オプションの操作)。
    boolean
    removeAll(Collection<?> c)
    指定されたコレクションにも 納されているこのコレクションのすべての要 を削除します(オプションの操作)。
    default boolean
    removeIf(Predicate<? super E> filter)
    指定された述語(オプションの操作)を満たす、このコレクションのすべての要 を削除します。
    boolean
    retainAll(Collection<?> c)
    このコレクションにおいて、指定されたコレクションに 納されている要  けを保持します(オプションの操作)。
    int
    size()
    このコレクション中の要 の数を返します。
    default Spliterator<E>
    spliterator()
    このコレクション内の要 に対するSpliteratorを作成します。
    default Stream<E>
    stream()
    このコレクションをソースとして使用して、逐次的なStreamを返します。
    Object[]
    toArray()
    このコレクションの要 がすべて 納されている配列を返します。
    default <T> T[]
    toArray(IntFunction<T[]> generator)
    指定されたgenerator関数を使用してこのコレクションのすべての要 を含む配列を返し、返された配列を割り当てます。
    <T> T[]
    toArray(T[] a)
    このコレクション内のすべての要 を保持する配列を返します。返される配列の実行時の型は、指定された配列の型です。

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

    forEach

  • メソッドの詳細

    • size

      int size()
      このコレクション中の要 の数を返します。 このコレクションに複数のInteger.MAX_VALUE要 が含まれている 合は、Integer.MAX_VALUEを返します。
      戻り値:
      このコレクションの要 数

    • isEmpty

      boolean isEmpty()
      このコレクションに要 がない 合にtrueを返します。
      戻り値:
      このコレクションに要 が含まれていない 合はtrue

    • contains

      boolean contains(Object o)
      このコレクションに指定した要 が含まれている 合は、trueを返します。 より正式には、このコレクションにObjects.equals(o, e)などの要 eが少なくとも1つ含まれている 合にのみ、trueを返します。
      パラメータ:
      o - このコレクション内にあるかどうかが判定される要 
      戻り値:
      このコレクションに指定した要 が含まれている 合はtrue
      スロー:
      ClassCastException - 指定された要 の型が、このコレクションと互換でない 合(オプション)
      NullPointerException - 指定された要 がnullで、このコレクションがnull要 を許可しない 合(オプション)

    • iterator

      Iterator<E> iterator()
      コレクションの要 のイテレータを返します。 要 が返される 序についての保証はありません。た し、このコレクションが、保証を提供するクラスのインスタンスである 合は例外です。
      定義:
      iterator、インタフェースIterable<E>
      戻り値:
      このコレクションの要 に対するIterator

    • toArray

      Object[] toArray()
      このコレクションの要 がすべて 納されている配列を返します。 イテレータによって要 が返される 序をコレクションが保証する 合、このメソッドは同じ 序で要 を返さなければなりません。 返される配列の「ランタイ ・コンポーネント・タイプ」はObjectです。

      返される配列への参照をコレクションが維持しないという点で、この配列は安全です。 つまり、このメソッドは、コレクションが配列に連動している 合でも新しい配列を割り当てます。 このため、呼出し側は、返された配列を自由に変更できます。

      APIのノート:
      このメソッドは、配列ベースおよびコレクションベースのAPIの間のブリッジ渡し役として機能します。 ランタイ ・タイプがObject[]の配列を戻します。 toArray(T[])を使用して既存の配列を再利用するか、toArray(IntFunction)を使用して配列の実行時の型を制御します。
      戻り値:
      「ランタイ ・コンポーネント・タイプ」がObjectの配列。このコレクションのすべての要 を含む

    • toArray

      <T> T[] toArray(T[] a)
      このコレクション内のすべての要 を保持する配列を返します。返される配列の実行時の型は、指定された配列の型です。 コレクションが指定された配列に収まる 合は、その中に返されます。 そうでない 合は、指定された配列の実行時の型とコレクションのサイズを持つ新しい配列が割り当てられます。

      このコレクションが(つまり、配列にはこのコレクションより多くの要 があります)の余裕のある指定された配列に収まる 合、コレクションの終端の直後の配列の要 はnullに設定されます。 (これは、このコレクションにnull要 が含まれていないことをコール元が認識している 合に、このコレクションonlyの長さを決定する際に役立ちます。)

      イテレータによって要 が返される 序をコレクションが保証する 合、このメソッドは同じ 序で要 を返さなければなりません。

      APIのノート:
      このメソッドは、配列ベースおよびコレクションベースのAPIの間のブリッジ渡し役として機能します。 特定の状況で既存の配列を再利用できます。 toArray()を使用して、実行時タイプがObject[]である配列を作成するか、toArray(IntFunction)を使用して配列の実行時タイプを制御します。

      xが文字列のみを含むことがわかっているコレクションであるとします。 次のコードを使用すると、コレクションを、以前に割り当てられたString配列にダンプできます。 

           String[] y = new String[SIZE];
     ...
     y = x.toArray(y);

      新しい配列が割り当てられ、コレクションxが既存の配列yに 納する要 が多すぎる 合に返されるため、戻り値はy変数に再割当てされます。

      toArray(new Object[0])は、機能の点でtoArray()と同一です。

      型パラメータ:
      T - コレクションを 納する配列のコンポーネント型
      パラメータ:
      a - 配列が十分な大きさを持つ 合は、このコレクションの要 の 納先の配列。配列のサイズが十分でない 合は、同じ実行時の型で新しい配列が 納用として割り当てられる。
      戻り値:
      コレクションのすべての要 が 納されている配列
      スロー:
      ArrayStoreException - このコレクション内の要 の実行時の型が、指定された配列の「ランタイ ・コンポーネント・タイプ」に代入可能でない 合
      NullPointerException - 指定された配列がnullである 合

    • toArray

      default <T> T[] toArray(IntFunction<T[]> generator)
      指定されたgenerator関数を使用してこのコレクションのすべての要 を含む配列を返し、返された配列を割り当てます。

      イテレータによって要 が返される 序をコレクションが保証する 合、このメソッドは同じ 序で要 を返さなければなりません。

      APIのノート:
      このメソッドは、配列ベースおよびコレクションベースのAPIの間のブリッジ渡し役として機能します。 これにより、特定の実行時タイプの配列を作成できます。 toArray()を使用して、ランタイ 型がObject[]の配列を作成するか、toArray(T[])を使用して既存の配列を再利用します。

      xが文字列のみを含むことがわかっているコレクションであるとします。 次のコードを使用して、新しく割り当てられたStringの配列にコレクションをダンプできます: 

           String[] y = x.toArray(String[]::new);

      実装要件:
      デフォルトの実装では、ゼロのジェネレータ関数をコールしてから、生成された配列をtoArray(T[])に渡します。
      型パラメータ:
      T - コレクションを 納する配列のコンポーネント型
      パラメータ:
      generator - 要求された型と指定された長さを持つ新しい配列を生成する関数
      戻り値:
      コレクションのすべての要 が 納されている配列
      スロー:
      ArrayStoreException - このコレクションのいずれかの要 の実行時タイプが、生成された配列の「ランタイ ・コンポーネント・タイプ」に割り当てられない 合
      NullPointerException - ジェネレータ・ファンクションがNullの 合
      導入されたバージョン:
      11

    • add

      boolean add(E e)
      指定された要 がこのコレクションに 納されていることを保証します(オプションの操作)。 このコレクションがコールの結果として変更された 合は、trueを返します。 (このコレクションで重複が許可されず、指定された要 がすでに含まれている 合は、falseを返します。)

      このオペレーションをサポートするコレクションでは、コレクションに追 できる要 について制限がある 合があります。 特に、一部のコレクションではnull要 の追 が拒否され、その他のコレクションでは追 できる要 のタイプに制限が課されます。 追 される要 に関して制限がある 合は、そのCollectionクラスのドキュメントに明示すべきでしょう。

      コレクションにすでに要 が含まれている理由以外で特定の要 の追 が拒否された 合、例外(falseを返すのではなく)をスローする必要があります。 これにより、この呼出しが戻ったあとにコレクションが指定された要 を必ず 納するという不変性を保つことができます。

      パラメータ:
      e - このコレクションにあるかどうかを調べる要 
      戻り値:
      コールの結果としてこのコレクションが変更された 合、true
      スロー:
      UnsupportedOperationException - add操作がこのコレクションでサポートされていない 合
      ClassCastException - 指定された要 のクラスが原 で、このコレクションにその要 を追 できない 合
      NullPointerException - 指定された要 がnullで、このコレクションがnull要 を許可しない 合
      IllegalArgumentException - 要 のあるプロパティが原 で、このコレクションに要 を追 できない 合
      IllegalStateException - 挿入制限のため、この時点で要 を追 できない 合

    • remove

      boolean remove(Object o)
      指定された要 のインスタンスがこのコレクションにあれば、そのインスタンスをコレクションから1つ削除します(オプションの操作)。 より正式には、要 eを削除して、このコレクションにそのような要 が1つ以上含まれている 合はObjects.equals(o, e)にします。 このコレクションに指定した要 (このコレクションがコールの結果として変更された 合、または同等)が含まれている 合は、trueを返します。
      パラメータ:
      o - このコレクションから削除される要 (その要 が存在する 合)
      戻り値:
      この呼出しの結果として要 が削除された 合はtrue
      スロー:
      ClassCastException - 指定された要 の型が、このコレクションと互換でない 合(オプション)
      NullPointerException - 指定された要 がnullで、このコレクションがnull要 を許可しない 合(オプション)
      UnsupportedOperationException - remove操作がこのコレクションでサポートされていない 合

    • containsAll

      boolean containsAll(Collection<?> c)
      指定したコレクションのすべての要 がこのコレクションに含まれている 合、trueを返します。
      パラメータ:
      c - このコレクションにあるかどうかを調べるコレクション
      戻り値:
      このコレクションに指定したコレクションのすべての要 が含まれている 合、true
      スロー:
      ClassCastException - 指定されたコレクションの1つ以上の要 の型が、このコレクションと互換でない 合(オプション)
      NullPointerException - 指定したコレクションに1つ以上のnull要 が含まれ、このコレクションでnull要 (optional)が許可されない 合、または指定されたコレクションがnullの 合。
      関連 目:

    • addAll

      boolean addAll(Collection<? extends E> c)
      指定されたコレクションのすべての要 をこのコレクションに追 します(オプションの操作)。 オペレーションの進行中に、指定されたコレクションが変更された 合の、このオペレーションの動作は定義されていません。 したがって、指定されたコレクションがこのコレクション自身であり、このコレクションが空ではない 合、この呼出しの動作は定義されていません。 指定したコレクションに「見つける」が定義されている 合、その要 の処理は通常、その 序で行われます。
      パラメータ:
      c - このコレクションに追 される要 を含むコレクション
      戻り値:
      コールの結果としてこのコレクションが変更された 合、true
      スロー:
      UnsupportedOperationException - addAll操作がこのコレクションでサポートされていない 合
      ClassCastException - 指定されたコレクションの要 のクラスが原 で、このコレクションにその要 を追 できない 合
      NullPointerException - 指定されたコレクション内にnull要 が含まれ、このコレクションがnull要 を許可しない 合。または指定されたコレクションがnullの 合
      IllegalArgumentException - 指定されたコレクションの要 のあるプロパティが原 で、このコレクションにその要 を追 できない 合
      IllegalStateException - 挿入制限のため、この時点で一部の要 を追 できない 合
      関連 目:

    • removeAll

      boolean removeAll(Collection<?> c)
      指定されたコレクションにも 納されているこのコレクションのすべての要 を削除します(オプションの操作)。 この呼出しの結果、このコレクションには指定されたコレクションと共通の要 はなくなります。
      パラメータ:
      c - このコレクションから削除される要 を含むコレクション
      戻り値:
      コールの結果としてこのコレクションが変更された 合、true
      スロー:
      UnsupportedOperationException - removeAll操作がこのコレクションでサポートされていない 合
      ClassCastException - このコレクション内の1つ以上の要 の型が、指定されたコレクションと互換でない 合(オプション)
      NullPointerException - このコレクションに1つ以上のnull要 が含まれ、指定したコレクションがnull要 (optional)をサポートしていない 合、または指定されたコレクションがnullの 合
      関連 目:

    • removeIf

      default boolean removeIf(Predicate<? super E> filter)
      指定された述語(オプションの操作)を満たす、このコレクションのすべての要 を削除します。 反復中に、または述語によってスローされたエラーまたは実行時例外は、呼出し側に中継されます。
      実装要件:
      デフォルトの実装では、そのiterator()を使用してコレクションのすべての要 をトラバースします。 一致する各要 は、Iterator.remove()を使って削除されます。 コレクションのイテレータが削除をサポートしていない 合は、最初に一致する要 に対してUnsupportedOperationExceptionがスローされます。
      パラメータ:
      filter - 削除される要 に対してtrueを返す述語
      戻り値:
      要 が削除された 合はtrue
      スロー:
      NullPointerException - 指定されたフィルタがnullである 合
      UnsupportedOperationException - removeIf操作がこのコレクションでサポートされていない 合
      導入されたバージョン:
      1.8

    • retainAll

      boolean retainAll(Collection<?> c)
      このコレクションにおいて、指定されたコレクションに 納されている要  けを保持します(オプションの操作)。 つまり、指定されたコレクションに 納されていないすべての要 をこのコレクションから削除します。
      パラメータ:
      c - このコレクションで保持される要 を含むコレクション
      戻り値:
      コールの結果としてこのコレクションが変更された 合、true
      スロー:
      UnsupportedOperationException - retainAll操作がこのコレクションでサポートされていない 合
      ClassCastException - このコレクション内の1つ以上の要 の型が、指定されたコレクションと互換でない 合(オプション)
      NullPointerException - このコレクションに1つ以上のnull要 が含まれ、指定したコレクションでnull要 (optional)が許可されていない 合、または指定されたコレクションがnullの 合
      関連 目:

    • clear

      void clear()
      このコレクションからすべての要 を削除します(オプションの操作)。 このメソッドが戻ると、コレクションは空になります。
      スロー:
      UnsupportedOperationException - clear操作がこのコレクションでサポートされていない 合

    • equals

      boolean equals(Object o)
      指定されたオブジェクトとこのコレクションが等しいかどうかを比較します。

      Collectionインタフェースは、Object.equalsの一般契約に規定を追 しませんが、Collectionインタフェース"直接" (つまり、Collectionですが、SetまたはListではないクラスを作成)を実装するプログラマは、Object.equalsをオーバーライドするように選択した 合は注意する必要があります。 これを行う必要はありません。最も簡単な操作は、Objectの実装に依存することです。た し、実装者はデフォルトの"参照比較。"のかわりに"値の比較"を実装する 合があります (ListおよびSetインタフェースでは、このような値の比較が必 です。)

      Object.equalsメソッドの一般的な契約では、等しいことが対称(つまり、b.equals(a)の 合のみa.equals(b))であることが示されます。 リストが他のリストとのみ等しく、他のセットに設定されているList.equalsおよびSet.equals状態の契約。 したがって、ListインタフェースもSetインタフェースも実装しないコレクション・クラスのカスタ equalsメソッドは、このコレクションが任意のリストまたはセットと比較されるときにfalseを返す必要があります。 (同じロジックで、SetインタフェースとListインタフェースの両方を正しく実装するクラスを記述することはできません。)

      オーバーライド:
      equals、クラスObject
      パラメータ:
      o - このコレクションと等しいかどうかが比較されるオブジェクト
      戻り値:
      指定したオブジェクトがこのコレクションと等しい 合はtrue
      関連 目:

    • hashCode

      int hashCode()
      コレクションのハッシュ・コード値を返します。 Collectionインタフェースでは、Object.hashCodeメソッドの一般契約に規定は追 されませんが、Object.equalsメソッドをオーバーライドするクラスは、Object.hashCodeメソッドの一般的な契約を満たすため、Object.hashCodeメソッドもオーバーライドする必要があることに注意してく さい。 特に、c1.equals(c2)はc1.hashCode()==c2.hashCode()を意味します。
      オーバーライド:
      hashCode、クラスObject
      戻り値:
      このコレクションのハッシュ・コード値
      関連 目:

    • spliterator

      default Spliterator<E> spliterator()
      このコレクション内の要 に対するSpliteratorを作成します。 実装では、このスプリッテレータによって 告された特性値をドキュメント化する必要があります。 スプリッテレータがSpliterator.SIZEDを 告し、このコレクションに要 が1つも含まれていない 合は、そのような特性値が 告される必要はありません。

      デフォルトの実装は、より効率的なスプリッテレータを返すことができるサブクラスによってオーバーライドされるべきです。 stream()およびparallelStream()メソッドで予想される遅延動作を保持するために、スプリッタはIMMUTABLEまたはCONCURRENTの特性を持つか、late-bindingである必要があります。 これらのどれも実現できない 合、オーバーライドするクラスはバインディングおよび構 上の干渉に関するスプリッテレータのドキュメント化されたポリシーを記述し、次にあるようにstream()およびparallelStream()メソッドをオーバーライドして、スプリッテレータのSupplierでストリー を作成するべきです。 

      
     Stream<E> s = StreamSupport.stream(() -> spliterator(), spliteratorCharacteristics)

      これらの要件により、stream()およびparallelStream()メソッドによって作成されたストリー は、ストリー 終端操作の開始以降、コレクションの内容を反 するようになります。

      定義:
      spliterator、インタフェースIterable<E>
      実装要件:
      デフォルトの実装では、コレクションのIteratorからlate-bindingスプリッタが作成されます。 このスプリッテレータは、コレクションのイテレータのフェイルファスト特性を継承します。

      作成されたSpliteratorはSpliterator.SIZEDを 告します。

      実装上のノート:
      作成されたSpliteratorはさらにSpliterator.SUBSIZEDも 告します。

      スプリッテレータの適用される要 がない 合は、SIZEDおよびSUBSIZEDの他に追 の特性値を 告しても、クライアントによる計算の制御、特殊化、または簡 化には役立ちません。 た し、これによって、不変および空のスプリッテレータ・インスタンス(Spliterators.emptySpliterator()を参照)を空のコレクションに共同利用できるようになり、そのようなスプリッテレータが適用される要 がないかどうかをクライアントが判定できるようになります。

      戻り値:
      このコレクション内の要 に対するSpliterator
      導入されたバージョン:
      1.8

    • stream

      default Stream<E> stream()
      このコレクションをソースとして使用して、逐次的なStreamを返します。

      このメソッドは、IMMUTABLE、CONCURRENT、または遅延バインディングであるスプリッテレータをspliterator()メソッドが返せない 合にオーバーライドされるべきです。 (詳細はspliterator()を参照。)

      実装要件:
      デフォルトの実装では、コレクションのSpliteratorから 次Streamを作成します。
      戻り値:
      このコレクション内の要 に対する 次Stream
      導入されたバージョン:
      1.8

    • parallelStream

      default Stream<E> parallelStream()
      このコレクションをソースとして、潜在的に並列のStreamを返します。 このメソッドは 次ストリー を返すことができます。

      このメソッドは、IMMUTABLE、CONCURRENT、または遅延バインディングであるスプリッテレータをspliterator()メソッドが返せない 合にオーバーライドされるべきです。 (詳細はspliterator()を参照。)

      実装要件:
      デフォルトの実装では、コレクションのSpliteratorから並列Streamを作成します。
      戻り値:
      このコレクション内の要 に対する、並列の可能性のあるStream
      導入されたバージョン:
      1.8