compact1, compact2, compact3

java.util

インタフェースList<E>

型パラメータ:

E - このリスト内に存在する要素の型

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

Collection<E>, Iterable<E>

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

AbstractList, AbstractSequentialList, ArrayList, AttributeList, CopyOnWriteArrayList, LinkedList, RoleList, RoleUnresolvedList, Stack, Vector

public interface List<E>
extends Collection<E>

順序付けられたコレクションです。シーケンスとも呼ばれます。このインタフェースのユーザーは、リスト内のどこに各要素が挿入されるかを精密に制御できます。ユーザーは整数値のインデックス(リスト内の位置)によって要素にアクセスしたり、リスト内の要素を検索したりできます。

セットとは異なり、通常、リストは重複する要素を許可します。つまり、リストは通常、e1.equals(e2)となるようなe1とe2の要素のペアを許可します。また、null要素を許可する場合には、通常は複数のnull要素を許可します。ユーザーが重複する値を挿入しようとしたときに実行時の例外をスローすることにより、重複する値を禁止するリストを実装する場合もありますが、このように使われることはほとんどありません。

Listインタフェースは、iterator、add、remove、equals、およびhashCodeの各メソッドの規約に対して、Collectionインタフェースで指定されているものに加えてさらに条項を追加します。便宜上、ほかの継承メソッドの宣言もここに含まれます。

Listインタフェースは、位置を指定して(インデックスで)リストの要素にアクセスするための4つのメソッドを提供します。Java配列と同様に、Listのインデックスは0から始まります。一部の実装(LinkedListクラスなど)では、これらのオペレーションの実行にはインデックス値に比例した時間がかかる場合があります。このため、呼出し側がこうした実装について知らない場合は、リストにインデックスを付けるよりも、リスト内の要素を反復してください。

Listインタフェースは、Iteratorインタフェースが提供する通常のオペレーションに加えて、要素の挿入、置換、および双方向アクセスを可能にする、ListIteratorという特殊なイテレータを提供します。リスト内の指定した位置から開始するリスト・イテレータを取得するためのメソッドが提供されています。

Listインタフェースは、指定したオブジェクトを検索するための2つのメソッドを提供します。パフォーマンスの観点からは、これらのメソッドは注意して使用する必要があります。多くの実装でこれらのメソッドは、時間のかかる線形探索を実行します。

リスト内の任意の位置に複数の要素を効率的に挿入および削除するために、Listインタフェースは2つのメソッドを提供します。

注: リストにリスト自体を要素として格納することも可能ですが、十分注意してください。そのようなリストではequalsメソッドおよびhashCodeメソッドの動作は保証されません。

リストの実装には、格納できる要素に制限があるものもあります。たとえば、null要素を禁止する実装や、null要素の型に制限がある実装もあります。不適格な要素を追加しようとすると、通常NullPointerExceptionまたはClassCastExceptionのような非チェック例外がスローされます。不適格な要素を照会しようとすると、例外がスローされる場合や、ただfalseを返す場合もあります。前者の動作を実行する実装もあれば、後者の動作を実行する実装もあります。もう少し一般的に言うと、不適当な要素を処理しようとしてリストへの挿入が完了しない場合、例外がスローされるか成功するかは実装の任意です。このインタフェースの仕様では、そうした例外は「任意」と記載されています。

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

導入されたバージョン:

1.2

関連項目:

Collection, Set, ArrayList, LinkedList, Vector, Arrays.asList(Object[]), Collections.nCopies(int, Object), Collections.EMPTY_LIST, AbstractList, AbstractSequentialList

メソッドのサマリー

修飾子と型	メソッドと説明
boolean	add(E e) 指定された要素をこのリストの最後に追加します(オプションの操作)。
void	add(int index, E element) このリスト内の指定された位置に、指定された要素を挿入します(オプションの操作)。
boolean	addAll(Collection<? extends E> c) 指定されたコレクション内のすべての要素を、指定されたコレクションのイテレータによって返される順序で、このリストの最後に追加します(オプションの操作)。
boolean	addAll(int index, Collection<? extends E> c) 指定されたコレクション内のすべての要素を、このリストの指定された位置に挿入します(オプションの操作)。
void	clear() すべての要素をこのリストから削除します(オプションの操作)。
boolean	contains(Object o) 指定の要素がこのリストに含まれている場合にtrueを返します。
boolean	containsAll(Collection<?> c) 指定されたコレクションのすべての要素がこのリストに含まれている場合にtrueを返します。
boolean	equals(Object o) 指定されたオブジェクトがこのリストと等しいかどうかを比較します。
E	get(int index) このリスト内の指定された位置にある要素を返します。
int	hashCode() このリストのハッシュ・コード値を返します。
int	indexOf(Object o) 指定された要素がこのリスト内で最初に検出された位置のインデックスを返します。指定された要素がこのリストにない場合は -1を返します。
boolean	isEmpty() このリストに要素がない場合にtrueを返します。
Iterator<E>	iterator() このリスト内の要素を適切な順序で反復するイテレータを返します。
int	lastIndexOf(Object o) 指定された要素がこのリスト内で最後に検出された位置のインデックスを返します。指定された要素がこのリストにない場合は -1を返します。
ListIterator<E>	listIterator() このリスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。
ListIterator<E>	listIterator(int index) リスト内の指定された位置で始まる、リスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。
E	remove(int index) このリスト内の指定された位置にある要素を削除します(オプションの操作)。
boolean	remove(Object o) 指定された要素がこのリストにあれば、その最初のものをリストから削除します(オプションの操作)。
boolean	removeAll(Collection<?> c) このリストから、指定されたコレクションに含まれる要素をすべて削除します(オプションの操作)。
default void	replaceAll(UnaryOperator<E> operator) このリストの各要素を、その要素に演算子を適用した結果で置換します。
boolean	retainAll(Collection<?> c) このリスト内で、指定されたコレクションに含まれている要素だけを保持します(オプションの操作)。
E	set(int index, E element) このリスト内の指定された位置にある要素を、指定された要素に置き換えます(オプションの操作)。
int	size() このリスト内にある要素の数を返します。
default void	sort(Comparator<? super E> c) 指定されたComparatorを使用して要素を比較することにより、このリストをソートします。
default Spliterator<E>	spliterator() このリスト内の要素に対するSpliteratorを作成します。
List<E>	subList(int fromIndex, int toIndex) このリストの、指定されたfromIndex (これを含む)からtoIndex (これを含まない)までの部分のビューを返します。
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()

このリストに要素がない場合にtrueを返します。

定義:

isEmpty、インタフェース: Collection<E>

戻り値:

このリストに要素が含まれていない場合はtrue

contains

boolean contains(Object o)

指定の要素がこのリストに含まれている場合にtrueを返します。つまり、このリストに、(o==null ? e==null : o.equals(e))となる要素eが1つ以上含まれている場合にのみ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>

戻り値:

このリスト内のすべての要素を適切な順序で含んでいる配列

関連項目:

Arrays.asList(Object[])

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)

指定された要素をこのリストの最後に追加します(オプションの操作)。

このオペレーションをサポートするリストは、リストに追加できる要素に制限を加える場合があります。たとえば、リストにはnull要素の追加を拒否するものもあれば、追加される要素の型について制限を加えるものもあります。Listクラスは、追加できる要素について制約があれば、ドキュメントでそれを明確に記述するようにしてください。

定義:

add、インタフェース: Collection<E>

パラメータ:

e - このリストに追加される要素

戻り値:

true (Collection.add(E)で指定されているとおり)

例外:

UnsupportedOperationException - addオペレーションがこのリストでサポートされない場合

ClassCastException - 指定された要素のクラスが原因で、このリストにその要素を追加できない場合

NullPointerException - 指定された要素がnullで、このリストがnull要素を許可しない場合

IllegalArgumentException - この要素のあるプロパティが原因で、このリストにその要素を追加できない場合

remove

boolean remove(Object o)

指定された要素がこのリストにあれば、その最初のものをリストから削除します(オプションの操作)。このリストにその要素がない場合は、変更されません。つまり、(o==null ? get(i)==null : o.equals(get(i)))となる、最小のインデックス値iを持つ要素を削除します(そのような要素が存在する場合)。指定された要素がこのリストに含まれていた場合(すなわち、呼出しの結果としてこのリストが変更された場合)はtrueを返します。

定義:

remove、インタフェース: Collection<E>

パラメータ:

o - このリストから削除される要素(その要素が存在する場合)

戻り値:

指定された要素がこのリストに含まれていた場合はtrue

例外:

ClassCastException - 指定された要素の型が、このリストと互換でない場合(オプション)

NullPointerException - 指定された要素がnullで、このリストがnull要素を許可しない場合(オプション)

UnsupportedOperationException - removeオペレーションがこのリストでサポートされない場合

containsAll

boolean containsAll(Collection<?> c)

指定されたコレクションのすべての要素がこのリストに含まれている場合にtrueを返します。

定義:

containsAll、インタフェース: Collection<E>

パラメータ:

c - このリストにあるかどうかがチェックされるコレクション

戻り値:

指定されたコレクションのすべての要素がこのリストに含まれている場合はtrue

例外:

ClassCastException - 指定されたコレクションの1つ以上の要素の型が、このリストと互換でない場合(オプション)

NullPointerException - 指定されたコレクションに1つ以上のnull要素が含まれており、このリストがnull要素を許可しない場合(オプション)、または指定されたコレクションがnullの場合

関連項目:

contains(Object)

addAll

boolean addAll(Collection<? extends E> c)

指定されたコレクション内のすべての要素を、指定されたコレクションのイテレータによって返される順序で、このリストの最後に追加します(オプションの操作)。オペレーションの進行中に指定されたコレクションが変更された場合の、このオペレーションの動作は定義されていません。(これは、指定されたコレクションがこのリストで、しかも空ではない場合に起こります。)

定義:

addAll、インタフェース: Collection<E>

パラメータ:

c - このリストに追加される要素を含むコレクション

戻り値:

呼出しの結果としてこのリストが変更された場合はtrue

例外:

UnsupportedOperationException - addAllオペレーションがこのリストでサポートされない場合

ClassCastException - 指定されたコレクションの要素のクラスが原因で、このリストにその要素を追加できない場合

NullPointerException - 指定されたコレクションに1つ以上のnull要素が含まれており、このリストがnull要素を許可しない場合、または指定されたコレクションがnullの場合

IllegalArgumentException - 指定されたコレクションの要素のあるプロパティが原因で、このリストにその要素を追加できない場合

関連項目:

add(Object)

addAll

boolean addAll(int index,
               Collection<? extends E> c)

指定されたコレクション内のすべての要素を、このリストの指定された位置に挿入します(オプションの操作)。その位置の現在の要素(ある場合)とそれ以降の要素を右に移動します(インデックスが増えます)。新しい要素は、指定されたコレクションのイテレータによって返される順序でこのリストに挿入されます。オペレーションの進行中に指定されたコレクションが変更された場合の、このオペレーションの動作は定義されていません。(これは、指定されたコレクションがこのリストで、しかも空ではない場合に起こります。)

パラメータ:

index - 指定されたコレクションの最初の要素を挿入する位置のインデックス

c - このリストに追加される要素を含むコレクション

戻り値:

呼出しの結果としてこのリストが変更された場合はtrue

例外:

UnsupportedOperationException - addAllオペレーションがこのリストでサポートされない場合

ClassCastException - 指定されたコレクションの要素のクラスが原因で、このリストにその要素を追加できない場合

NullPointerException - 指定されたコレクションに1つ以上のnull要素が含まれており、このリストがnull要素を許可しない場合、または指定されたコレクションがnullの場合

IllegalArgumentException - 指定されたコレクションの要素のあるプロパティが原因で、このリストにその要素を追加できない場合

IndexOutOfBoundsException - インデックスが範囲外の場合(index < 0||index> size())

removeAll

boolean removeAll(Collection<?> c)

このリストから、指定されたコレクションに含まれる要素をすべて削除します(オプションの操作)。

定義:

removeAll、インタフェース: Collection<E>

パラメータ:

c - このリストから削除される要素を含むコレクション

戻り値:

呼出しの結果としてこのリストが変更された場合はtrue

例外:

UnsupportedOperationException - removeAllオペレーションがこのリストでサポートされない場合

ClassCastException - このリストのある要素のクラスが、指定されたコレクションと互換でない場合(オプション)

NullPointerException - このリストにnull要素が含まれており、指定されたコレクションがnull要素を許可しない場合(オプション)、または指定されたコレクションがnullの場合

関連項目:

remove(Object), contains(Object)

retainAll

boolean retainAll(Collection<?> c)

このリスト内で、指定されたコレクションに含まれている要素だけを保持します(オプションの操作)。つまり、指定されたコレクションに含まれていないすべての要素をこのリストから削除します。

定義:

retainAll、インタフェース: Collection<E>

パラメータ:

c - このリストで保持される要素を含むコレクション

戻り値:

呼出しの結果としてこのリストが変更された場合はtrue

例外:

UnsupportedOperationException - retainAllオペレーションがこのリストでサポートされない場合

ClassCastException - このリストのある要素のクラスが、指定されたコレクションと互換でない場合(オプション)

NullPointerException - このリストにnull要素が含まれており、指定されたコレクションがnull要素を許可しない場合(オプション)、または指定されたコレクションがnullの場合

関連項目:

remove(Object), contains(Object)

replaceAll

default void replaceAll(UnaryOperator<E> operator)

このリストの各要素を、その要素に演算子を適用した結果で置換します。演算子によってスローされたエラーまたは実行時例外は、呼出し側に中継されます。

実装要件:

このリストでは、デフォルト実装は次と同等です。

     final ListIterator<E> li = list.listIterator();
     while (li.hasNext()) {
         li.set(operator.apply(li.next()));
     }
 

このリストのリスト・イテレータがset操作をサポートしない場合、最初の要素を置き換えるときにUnsupportedOperationExceptionがスローされます。

パラメータ:

operator - 各要素に適用する演算子

例外:

UnsupportedOperationException - このリストが変更できない場合。実装は、要素を置換できない場合、または一般的には変更がサポートされていない場合、この例外をスローすることがある。

NullPointerException - 指定された演算子がnull、または演算子の結果がnull値でこのリストがnull要素を許可しない場合(オプション)

導入されたバージョン:

1.8

sort

default void sort(Comparator<? super E> c)

指定されたComparatorを使用して要素を比較することにより、このリストをソートします。

実装要件:

このリストでは、デフォルト実装は次と同等です。

Collections.sort(list, c)

パラメータ:

c - リスト要素を比較するために使用されるComparator。null値は、要素の自然順序付けが使用されることを示す

例外:

ClassCastException - リストに、指定されたコンパレータで相互比較できない要素が含まれる場合

UnsupportedOperationException - リストのリスト・イテレータがset操作をサポートしない場合。

IllegalArgumentException - (オプション)コンパレータがComparator規約に違反していることが見つかった場合

導入されたバージョン:

1.8

clear

void clear()

すべての要素をこのリストから削除します(オプションの操作)。この呼出しが戻ると、このリストは空になります。

定義:

clear、インタフェース: Collection<E>

例外:

UnsupportedOperationException - clearオペレーションがこのリストでサポートされない場合

equals

boolean equals(Object o)

指定されたオブジェクトがこのリストと等しいかどうかを比較します。指定されたオブジェクトもリストであり、サイズが同じで、2つのリストの対応する要素がすべて等しい場合にだけtrueを返します。2つの要素e1とe2は、(e1==null ? e2==null : e1.equals(e2))である場合に等しくなります。つまり2つのリストは、同じ要素が同じ順序で含まれている場合に等しいものとして定義されます。この定義により、Listインタフェースの実装が異なっても、equalsメソッドが正しく動作することが保証されます。

定義:

equals、インタフェース: Collection<E>

オーバーライド:

equals、クラス: Object

パラメータ:

o - このリストと等しいかどうかを比較するオブジェクト

戻り値:

指定されたオブジェクトがこのリストと等しい場合はtrue

関連項目:

Object.hashCode(), HashMap

hashCode

int hashCode()

このリストのハッシュ・コード値を返します。リストのハッシュ・コードは、次の計算の結果として定義されます。

     int hashCode = 1;
     for (E e : list)
         hashCode = 31*hashCode + (e==null ? 0 : e.hashCode());
 

これにより、Object.hashCode()の一般規約によって要求されるように、任意の2つのリストlist1とlist2でlist1.equals(list2)であれば、list1.hashCode()==list2.hashCode()となることが保証されます。

定義:

hashCode、インタフェース: Collection<E>

オーバーライド:

hashCode、クラス: Object

戻り値:

このリストのハッシュ・コード値

関連項目:

Object.equals(Object), equals(Object)

get

E get(int index)

このリスト内の指定された位置にある要素を返します。

パラメータ:

index - 返される要素のインデックス

戻り値:

このリスト内の指定された位置にある要素

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合(index < 0||index>= size())

set

E set(int index,
      E element)

このリスト内の指定された位置にある要素を、指定された要素に置き換えます(オプションの操作)。

パラメータ:

index - 置換される要素のインデックス

element - 指定された位置に格納される要素

戻り値:

指定された位置に以前あった要素

例外:

UnsupportedOperationException - setオペレーションがこのリストでサポートされない場合

ClassCastException - 指定された要素のクラスが原因で、このリストにその要素を追加できない場合

NullPointerException - 指定された要素がnullで、このリストがnull要素を許可しない場合

IllegalArgumentException - 指定された要素のあるプロパティが原因で、このリストにその要素を追加できない場合

IndexOutOfBoundsException - インデックスが範囲外の場合(index < 0||index>= size())

add

void add(int index,
         E element)

このリスト内の指定された位置に、指定された要素を挿入します(オプションの操作)。その位置の現在の要素(ある場合)とそれ以降の要素を右に移動します(インデックスに1を加算)。

パラメータ:

index - 指定の要素が挿入される位置のインデックス

element - 挿入される要素

例外:

UnsupportedOperationException - addオペレーションがこのリストでサポートされない場合

ClassCastException - 指定された要素のクラスが原因で、このリストにその要素を追加できない場合

NullPointerException - 指定された要素がnullで、このリストがnull要素を許可しない場合

IllegalArgumentException - 指定された要素のあるプロパティが原因で、このリストにその要素を追加できない場合

IndexOutOfBoundsException - インデックスが範囲外の場合(index < 0||index> size())

remove

E remove(int index)

このリスト内の指定された位置にある要素を削除します(オプションの操作)。後続の要素を左に移動します(インデックスから1を減算)。リストから削除された要素が返されます。

パラメータ:

index - 削除される要素のインデックス

戻り値:

指定された位置に以前あった要素

例外:

UnsupportedOperationException - removeオペレーションがこのリストでサポートされない場合

IndexOutOfBoundsException - インデックスが範囲外の場合(index < 0||index>= size())

indexOf

int indexOf(Object o)

指定された要素がこのリスト内で最初に検出された位置のインデックスを返します。指定された要素がこのリストにない場合は -1を返します。つまり、(o==null ? get(i)==null : o.equals(get(i)))となる、最小のインデックスiを返します。そのようなインデックスが存在しない場合は -1を返します。

パラメータ:

o - 検索する要素

戻り値:

指定された要素がこのリスト内で最初に検出された位置のインデックス。その要素がこのリストにない場合は -1

例外:

ClassCastException - 指定された要素の型が、このリストと互換でない場合(オプション)

NullPointerException - 指定された要素がnullで、このリストがnull要素を許可しない場合(オプション)

lastIndexOf

int lastIndexOf(Object o)

指定された要素がこのリスト内で最後に検出された位置のインデックスを返します。指定された要素がこのリストにない場合は -1を返します。つまり、(o==null ? get(i)==null : o.equals(get(i)))となる、最大のインデックスiを返します。そのようなインデックスが存在しない場合は -1を返します。

パラメータ:

o - 検索する要素

戻り値:

指定された要素がこのリスト内で最後に検出された位置のインデックス。その要素がこのリストにない場合は -1

例外:

ClassCastException - 指定された要素の型が、このリストと互換でない場合(オプション)

NullPointerException - 指定された要素がnullで、このリストがnull要素を許可しない場合(オプション)

listIterator

ListIterator<E> listIterator()

このリスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。

戻り値:

このリスト内の要素を(適切な順序で)反復するリスト・イテレータ

listIterator

ListIterator<E> listIterator(int index)

リスト内の指定された位置で始まる、リスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。指定されたインデックスは、nextの最初の呼出しによって返される最初の要素を示します。previousの最初の呼出しは、指定されたインデックスから1を引いたインデックスを持つ要素を返します。

パラメータ:

index - リスト・イテレータから(next呼出しによって)返される最初の要素のインデックス

戻り値:

リスト内の指定された位置で始まる、リスト内の要素を(適切な順序で)反復するリスト・イテレータ

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合(index < 0||index> size())

subList

List<E> subList(int fromIndex,
                int toIndex)

このリストの、指定されたfromIndex (これを含む)からtoIndex (これを含まない)までの部分のビューを返します。fromIndexとtoIndexが等しい場合は、空のリストが返されます。返されるリストはこのリストに連動しているため、返されるリスト内での非構造的な変更はこのリストに反映され、このリスト内での変更は返されるリストに反映されます。返されるリストは、このリストによってサポートされている、任意のリスト・オペレーションをすべてサポートします。

このメソッドでは、配列に一般的に見られるような、明示的な範囲操作は必要ありません。リストを予期する操作は、リスト全体ではなくsubListビューを渡すことで範囲操作として使用できます。たとえば、次のイディオムは、ある範囲の要素をリストから削除します。

      list.subList(from, to).clear();
 

indexOfおよびlastIndexOfでも同様のイディオムを構築して、CollectionsクラスのすべてのアルゴリズムをsubListに適用できます。

バッキング・リスト(すなわち、このリスト)の構造が、返されたリストを経由せずに変更された場合、このメソッドで返されるリストのセマンティックスは定義されていません。構造の変更とは、リストのサイズが変わるような変更や、進行中のイテレーションが不正な結果に終わるような変更のことです。

パラメータ:

fromIndex - subListの下端点(これを含む)

toIndex - subListの上端点(これを含まない)

戻り値:

このリスト内の指定された範囲のビュー

例外:

IndexOutOfBoundsException - 端点のインデックス値が不正である場合(fromIndex < 0||toIndex> size||fromIndex> toIndex)

spliterator

default Spliterator<E> spliterator()

このリスト内の要素に対するSpliteratorを作成します。

Spliteratorは、Spliterator.SIZEDおよびSpliterator.ORDEREDを報告します。実装は、追加の特性値の報告をドキュメント化する必要があります。

定義:

spliterator、インタフェース: Collection<E>

定義:

spliterator、インタフェース: Iterable<E>

実装要件:

デフォルト実装は、リストのIteratorから遅延バインディング・スプリッテレータを作成します。スプリッテレータは、リストのイテレータのフェイルファスト・プロパティを継承します。

実装上の注意:

作成されたSpliteratorはさらにSpliterator.SUBSIZEDも報告します。

戻り値:

このリスト内の要素に対するSpliterator

導入されたバージョン:

1.8