- 型パラメータ:
E
- このコレクション内の要素の型
- すべてのスーパー・インタフェース:
Collection<E>
,Iterable<E>
- 既知のすべてのサブインタフェース:
BlockingDeque<E>
,ClassPrinter.ListNodePREVIEW
,Deque<E>
,List<E>
,NavigableSet<E>
,SequencedSet<E>
,SortedSet<E>
- 既知のすべての実装クラス:
AbstractList
,AbstractSequentialList
,ArrayDeque
,ArrayList
,AttributeList
,ConcurrentLinkedDeque
,ConcurrentSkipListSet
,CopyOnWriteArrayList
,LinkedBlockingDeque
,LinkedHashSet
,LinkedList
,RoleList
,RoleUnresolvedList
,Stack
,TreeSet
,Vector
(この定義は、コンピュータのメモリー内のロケーションなど、要素の物理的なロケーション設定を意味するものではありません。)
Collection
インタフェースから継承されたいくつかのメソッドは、このコレクションの出現順序に従って要素を操作するために必要です。 たとえば、iterator
メソッドは、最初の要素から開始して、連続する要素から最後の要素まで続く要素を提供します。 検出順序で要素を処理するために必要なその他のメソッドには、次のものがあります: forEach
、parallelStream
、spliterator
、stream
、およびtoArray
メソッドのすべてのオーバーロード。
このインタフェースには、コレクションの両端に要素を追加、取得および削除するメソッドがあります。
このインタフェースは、このコレクションの逆順viewを提供するreversed
メソッドも定義します。 順序の逆のビューでは、後任者と前任者の概念と同様に、最初と最後の概念が反転します。 このコレクションの最初の要素は、逆順ビューの最後の要素であり、その逆も同様です。 このコレクションの一部の要素の後継は、戻し処理されたビューの先行作業です。その逆も同様です。 コレクションの出現順序を尊重するすべてのメソッドは、検出順序が反転しているかのように動作します。 たとえば、逆方向ビューのCollection.iterator()
メソッドは、このコレクションの最後の要素から最初の要素までの順に要素をレポートします。 reversed
メソッドの可用性と、適用可能なすべてのメソッドの順序付けセマンティクスへの影響により、このコレクションの要素を順方向または逆順で簡単に反復、検索、コピーおよびストリーミングできます。
このクラスは、Java Collections Frameworkのメンバーです。
- APIのノート:
- このインタフェースでは、
equals
およびhashCode
メソッドの要件は課されません。これは、サブインタフェースList
およびSequencedSet
(Set
から要件を継承)によって課される要件が競合するためです。 詳細は、Collection.equals
およびCollection.hashCode
の仕様を参照してください。 - 導入されたバージョン:
- 21
-
メソッドのサマリー
修飾子と型メソッド説明default void
このコレクションの最初の要素として要素を追加します (オプションの操作)。default void
このコレクションの最後の要素として要素を追加します (オプションの操作)。default E
getFirst()
このコレクションの最初の要素を取得します。default E
getLast()
このコレクションの最後の要素を取得します。default E
このコレクションの最初の要素を削除して返します(オプションの操作)。default E
このコレクションの最後の要素を削除して返します(オプションの操作)。reversed()
このコレクションの逆順viewを返します。
-
メソッドの詳細
-
reversed
SequencedCollection<E> reversed()このコレクションの逆順viewを返します。 返されるビュー内の要素の出現順序は、このコレクション内の要素の出現順序の逆です。 逆の順序付けは、返されるビューのビュー・コレクションに含まれるすべての順序依存操作に影響します。 コレクション実装でこのビューの変更が許可されている場合、ベースとなるコレクションへの変更"ライトスルー"。 実装によっては、基礎となるコレクションに対する変更が、この逆方向ビューに表示される場合と表示されない場合があります。- 戻り値:
- このコレクションの逆順表示
-
addFirst
default void addFirst(E e) このコレクションの最初の要素として要素を追加します (オプションの操作)。 この操作が正常に完了すると、指定された要素はこのコレクションのメンバーになり、発生順に最初の要素になります。- 実装要件:
- このインタフェースの実装では、常に
UnsupportedOperationException
がスローされます。 - パラメータ:
e
- 追加する要素- 例外:
NullPointerException
- 指定された要素がnullで、このコレクションがnull要素を許可しない場合UnsupportedOperationException
- このコレクション実装がこの操作をサポートしていない場合
-
addLast
default void addLast(E e) このコレクションの最後の要素として要素を追加します (オプションの操作)。 この操作が正常に完了すると、指定された要素はこのコレクションのメンバーになり、最後の要素が出現順になります。- 実装要件:
- このインタフェースの実装では、常に
UnsupportedOperationException
がスローされます。 - パラメータ:
e
- 追加する要素。- 例外:
NullPointerException
- 指定された要素がnullで、このコレクションがnull要素を許可しない場合UnsupportedOperationException
- このコレクション実装がこの操作をサポートしていない場合
-
getFirst
default E getFirst()このコレクションの最初の要素を取得します。- 実装要件:
- このインタフェースの実装では、このコレクションのイテレータを取得し、イテレータの
next
メソッドをコールして要素を取得します。 スローされたNoSuchElementException
は伝播されます。 それ以外の場合は、エレメントが返されます。 - 戻り値:
- 取得された要素
- 例外:
NoSuchElementException
- このコレクションが空の場合
-
getLast
default E getLast()このコレクションの最後の要素を取得します。- 実装要件:
- このインタフェースの実装では、このコレクションの逆方向ビューのイテレータを取得し、イテレータの
next
メソッドをコールして要素を取得します。 スローされたNoSuchElementException
は伝播されます。 それ以外の場合は、エレメントが返されます。 - 戻り値:
- 取得された要素
- 例外:
NoSuchElementException
- このコレクションが空の場合
-
removeFirst
default E removeFirst()このコレクションの最初の要素を削除して返します(オプションの操作)。- 実装要件:
- このインタフェースの実装では、このコレクションのイテレータを取得し、イテレータの
next
メソッドをコールして要素を取得します。 スローされたNoSuchElementException
は伝播されます。 次に、イテレータのremove
メソッドをコールします。 スローされたUnsupportedOperationException
は伝播されます。 次に、要素を返します。 - 戻り値:
- 削除される要素
- 例外:
NoSuchElementException
- このコレクションが空の場合UnsupportedOperationException
- このコレクション実装がこの操作をサポートしていない場合
-
removeLast
default E removeLast()このコレクションの最後の要素を削除して返します(オプションの操作)。- 実装要件:
- このインタフェースの実装では、このコレクションの逆方向ビューのイテレータを取得し、イテレータの
next
メソッドをコールして要素を取得します。 スローされたNoSuchElementException
は伝播されます。 次に、イテレータのremove
メソッドをコールします。 スローされたUnsupportedOperationException
は伝播されます。 次に、要素を返します。 - 戻り値:
- 削除される要素
- 例外:
NoSuchElementException
- このコレクションが空の場合UnsupportedOperationException
- このコレクション実装がこの操作をサポートしていない場合
-