クラスArrayList<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<E>

型パラメータ:

E - このリストの要� のタイプ

すべての実装されたインタフェース:

Serializable, Cloneable, Iterable<E>, Collection<E>, List<E>, RandomAccess, SequencedCollection<E>

直系の既知のサブクラス:

AttributeList, RoleList, RoleUnresolvedList

public class ArrayList<E> extends AbstractList<E> implements List<E>, RandomAccess, Cloneable, Serializable

Listインタフェースのサイズ変更可能な配列実装。 オプションのリスト操作をすべて実装し、nullを含むすべての要� を許可します。 このクラスは、Listインタフェースの実装に� えて、リストの� �納に内部的に使用される配列のサイズを操作するメソッドを提供します。 (このクラスは、非同期である点を除き、ほぼVectorと同等です。)

size, isEmpty, get, set, getFirst, getLast, removeLast, iterator, listIteratorおよびreversed操作は、一定時間で実行されます。 addおよびaddLast操作は、「償却定数時間」で実行されます。つまり、n個の要� requiresO(n)時間を追� します。 ほとんどの� �合、ほかのすべての処理も比例的な時間で実行されます。 定数係数は、LinkedList実装の� �合と比べて低くなります。

各ArrayListインスタンスには、「容量」があります。 容量とは、リストの要� を� �納するために使用する配列のサイズです。 これは常にリストのサイズ以上の大きさになります。 ArrayListに要� を追� すると、その容量は自動的に拡大します。 拡大のポリシーについては、要� を追� すると「一定の償却時間コスト」が伴うこと以外は、詳しくは指定されていません。

アプリケーションでは、ensureCapacity操作を使用して多数の要� を追� する前に、ArrayListインスタンスの容量を増やすことができます。 これにより、増� に対する再割当てが軽減される� �合があります。

この実装はsynchronizedされません。 複数のスレッドが同時にArrayListインスタンスにアクセスし、1つ以上のスレッドがリストを構� 的に変更する� �合、外部で同期する必要があります。 構� 的な変更とは、1つ以上の要� を追� または削除したり、基になる配列のサイズを明示的に変更したりする処理のことです。要� の値� けを設定する処理は、構� 的な変更ではありません。 これは通常、リストを自然にカプセル化する一部のオブジェクトでsynchronizedすることによって達成されます。 そのようなオブジェクトが存在しない� �合は、Collections.synchronizedListメソッドを使用してリストを「ラップ」するようにしてく� さい。 リストが誤ってsynchronizedなしでアクセスされるのを防ぐために、作成時に行うことをお薦めします。

   List list = Collections.synchronizedList(new ArrayList(...));

このクラスのiteratorおよびlistIteratorメソッドによって返されるイテレータは、fail-fastです: イテレータの作成後、イテレータ独自のremoveメソッドまたはaddメソッドを介してリストが構� 的に変更された� �合は、イテレータはConcurrentModificationExceptionをスローします。 このように、並行して変更が行われると、イテレータは、将来の予測できない時点において予測できない動作が発生する危険を回避するために、た� ちにかつ手際よく例外をスローします。

通常、非同期の並行変更がある� �合、確かな保証を行うことは不可能なので、イテレータのフェイルファストの動作を保証することはできません。 フェイルファスト・イテレータは、ベスト・エフォート・ベースでConcurrentModificationExceptionをスローします。 したがって、正確を期すためにこの例外に依存するプログラ� を書くことは誤りです。イテレータのフェイルファストの動作はバグを検出するためにのみ使用すべきです。

このクラスは、Java Collections Frameworkのメンバーです。

導入されたバージョン:

1.2

関連� �目:

• Collection
• List
• LinkedList
• Vector
• 直列化された形式

フィールドのサマリー

クラスjava.util.AbstractListで宣言されたフィールド

modCount

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
ArrayList()	初期容量10で空のリストを作成します。
ArrayList(int initialCapacity)	指定された初期容量で空のリストを作成します。
ArrayList(Collection<? extends E> c)	指定されたコレクションの要� が含まれているリストを、コレクションのイテレータによって返される� �序で構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	add(int index, E element)	リスト内の指定された位置に指定された要� を挿入します。
boolean	add(E e)	リストの最後に、指定された要� を追� します。
boolean	addAll(int index, Collection<? extends E> c)	指定されたコレクション内のすべての要� を、リストの指定された位置に挿入します。
boolean	addAll(Collection<? extends E> c)	指定されたコレクション内のすべての要� を、指定されたコレクションのイテレータによって返される� �序でリストの最後に追� します。
void	addFirst(E element)	このコレクションの最初の要� として要� を追� します (オプションの操作)。
void	addLast(E element)	このコレクションの最後の要� として要� を追� します (オプションの操作)。
void	clear()	このリストからすべての要� を削除します。
Object	clone()	このArrayListインスタンスのシャロー・コピーを返します。
boolean	contains(Object o)	指定された要� がこのリストに含まれている� �合にtrueを返します。
void	ensureCapacity(int minCapacity)	必要に応じて、このArrayListインスタンスの容量を増やし、最小容量引数で指定された要� 数以上を保持できるようにします。
boolean	equals(Object o)	指定されたオブジェクトがこのリストと等しいかどうかを比較します。
void	forEach(Consumer<? super E> action)	Iterableの各要� に対して指定されたアクションを、すべての要� が処理されるか、アクションが例外をスローするまで実行します。
E	get(int index)	このリスト内の指定された位置にある要� を返します。
E	getFirst()	このコレクションの最初の要� を取得します。
E	getLast()	このコレクションの最後の要� を取得します。
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)	リストから、指定されたコレクション内に保持されているすべての要� を削除します。
E	removeFirst()	このコレクションの最初の要� を削除して返します(オプションの操作)。
boolean	removeIf(Predicate<? super E> filter)	指定された述語(オプションの操作)を満たす、このコレクションのすべての要� を削除します。
E	removeLast()	このコレクションの最後の要� を削除して返します(オプションの操作)。
protected void	removeRange(int fromIndex, int toIndex)	fromIndex (これを含む)からtoIndex (これを含まない)の範囲のインデックスを持つすべての要� をこのリストから削除します。
boolean	retainAll(Collection<?> c)	指定されたコレクション内に保持されている、リスト内の要� � けを保持します。
E	set(int index, E element)	リストの指定された位置にある要� を、指定された要� で置き換えます。
int	size()	このリスト内にある要� の数を返します。
Spliterator<E>	spliterator()	このリスト内の要� に対する遅延バインディングおよびフェイルファスト Spliteratorを作成します。
List<E>	subList(int fromIndex, int toIndex)	このリストの、指定されたfromIndex (これを含む)からtoIndex (これを含まない)までの部分のビューを返します。
Object[]	toArray()	このリスト内のすべての要� を適切な� �序で(最初の要� から最後の要� へ)含んでいる配列を返します。
<T> T[]	toArray(T[] a)	このリスト内のすべての要� を適切な� �序で(最初の要� から最後の要� へ)含んでいる配列を返します。返される配列の実行時の型は、指定された配列の型になります。
void	trimToSize()	このArrayListインスタンスの容量をリストの現在のサイズに切り捨てます。

クラスjava.util.AbstractListで宣言されたメソッド

equals, hashCode

クラスjava.util.AbstractCollectionで宣言されたメソッド

containsAll, toString

クラスjava.lang.Objectで宣言されたメソッド

finalize, getClass, notify, notifyAll, wait, wait, wait

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

parallelStream, stream, toArray

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

containsAll, replaceAll, reversed, sort

コンストラクタの詳細

ArrayList

public ArrayList(int initialCapacity)

指定された初期容量で空のリストを作成します。

パラメータ:

initialCapacity - リストの初期容量

スロー:

IllegalArgumentException - 指定された初期容量が� の� �合

ArrayList

public ArrayList()

初期容量10で空のリストを作成します。

ArrayList

public ArrayList(Collection<? extends E> c)

指定されたコレクションの要� が含まれているリストを、コレクションのイテレータによって返される� �序で構築します。

パラメータ:

c - 要� がこのリストに配置されるコレクション

スロー:

NullPointerException - 指定されたコレクションがnullである� �合

メソッドの詳細

trimToSize

public void trimToSize()

このArrayListインスタンスの容量をリストの現在のサイズに切り捨てます。 アプリケーションは、この操作を使用して、ArrayListインスタンスのストレージを最小化できます。

ensureCapacity

public void ensureCapacity(int minCapacity)

必要に応じて、このArrayListインスタンスの容量を増やし、最小容量引数で指定された要� 数以上を保持できるようにします。

パラメータ:

minCapacity - 目的の最小容量

size

public int size()

このリスト内にある要� の数を返します。

定義:

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

定義:

size、インタフェースList<E>

戻り値:

このリスト内の要� 数

isEmpty

public boolean isEmpty()

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

定義:

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

定義:

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

オーバーライド:

isEmpty、クラスAbstractCollection<E>

戻り値:

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

contains

public boolean contains(Object o)

指定された要� がこのリストに含まれている� �合にtrueを返します。 より正式には、このリストにObjects.equals(o, e)などの要� eが少なくとも1つ含まれている� �合のみ、trueを返します。

定義:

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

定義:

contains、インタフェースList<E>

オーバーライド:

contains、クラスAbstractCollection<E>

パラメータ:

o - このリスト内にあるかどうかが判定される要�

戻り値:

指定された要� がこのリスト内にある� �合はtrue

indexOf

public int indexOf(Object o)

指定された要� がこのリスト内で最初に検出された位置のインデックスを返します。指定された要� がこのリストにない� �合は -1を返します。 より正式には、Objects.equals(o, get(i))のように最も低い索引iを戻し、そのような索引がない� �合は -1を戻します。

定義:

indexOf、インタフェースList<E>

オーバーライド:

indexOf、クラスAbstractList<E>

パラメータ:

o - 検索する要�

戻り値:

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

lastIndexOf

public int lastIndexOf(Object o)

指定された要� がこのリスト内で最後に検出された位置のインデックスを返します。指定された要� がこのリストにない� �合は -1を返します。 より正式には、Objects.equals(o, get(i))のように最も高い索引iを戻し、そのような索引がない� �合は -1を戻します。

定義:

lastIndexOf、インタフェースList<E>

オーバーライド:

lastIndexOf、クラスAbstractList<E>

パラメータ:

o - 検索する要�

戻り値:

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

clone

public Object clone()

このArrayListインスタンスのシャロー・コピーを返します。 要� 自体はコピーされません。

オーバーライド:

clone、クラスObject

戻り値:

このArrayListインスタンスのクローン

関連� �目:

• Cloneable

toArray

public Object[] toArray()

このリスト内のすべての要� を適切な� �序で(最初の要� から最後の要� へ)含んでいる配列を返します。

返される配列は、それへの参照がこのリストで保持されない� �合に、安全になります。 (つまり、このメソッドは新しい配列を割り当てます)。 このため、呼出し側は、返された配列を自由に変更できます。

このメソッドは、配列ベースのAPIとコレクションベースのAPIの間の橋渡し役として機能します。

定義:

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

定義:

toArray、インタフェースList<E>

オーバーライド:

toArray、クラスAbstractCollection<E>

戻り値:

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

関連� �目:

• Arrays.asList(Object[])

toArray

public <T> T[] toArray(T[] a)

このリスト内のすべての要� を適切な� �序で(最初の要� から最後の要� へ)含んでいる配列を返します。返される配列の実行時の型は、指定された配列の型になります。 指定された配列にリストが収まる� �合は、その配列で返されます。 それ以外の� �合は、指定された配列の実行時の型とこのリストのサイズを使って新しい配列が割り当てられます。

リストが(つまり、配列にはリストより多くの要� があります)の余裕のある指定された配列に収まる� �合、コレクションの終端の直後の配列の要� はnullに設定されます。 (このリストにnull要� がないことを呼出し側が知っている� �合にのみ、この特性を利用してリストの長さを判断できます。)

定義:

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

定義:

toArray、インタフェースList<E>

オーバーライド:

toArray、クラスAbstractCollection<E>

型パラメータ:

T - コレクションを� �納する配列のコンポーネント型

パラメータ:

a - 配列が十分な大きさを持つ� �合は、このリストの要� の� �納先の配列。配列のサイズが十分でない� �合は、同じ実行時の型で新しい配列が� �納用として割り当てられる。

戻り値:

リストの要� が� �納されている配列

スロー:

ArrayStoreException - 指定された配列の実行時の型が、このリスト内のすべての要� の実行時の型のスーパー・タイプではない� �合

NullPointerException - 指定された配列がnullである� �合

get

public E get(int index)

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

定義:

get、インタフェースList<E>

定義:

get、クラスAbstractList<E>

パラメータ:

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

戻り値:

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

スロー:

IndexOutOfBoundsException - 索引が(index < 0 || index >= size())の範囲外であるかどうか

getFirst

public E getFirst()

このコレクションの最初の要� を取得します。

定義:

インタフェースList<E>内のgetFirst

定義:

インタフェースSequencedCollection<E>内のgetFirst

戻り値:

取得された要�

スロー:

NoSuchElementException - このコレクションが空の� �合

導入されたバージョン:

21

getLast

public E getLast()

このコレクションの最後の要� を取得します。

定義:

インタフェースList<E>内のgetLast

定義:

インタフェースSequencedCollection<E>内のgetLast

戻り値:

取得された要�

スロー:

NoSuchElementException - このコレクションが空の� �合

導入されたバージョン:

21

set

public E set(int index, E element)

リストの指定された位置にある要� を、指定された要� で置き換えます。

定義:

set、インタフェースList<E>

オーバーライド:

set、クラスAbstractList<E>

パラメータ:

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

element - 指定された位置に� �納される要� 。

戻り値:

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

スロー:

IndexOutOfBoundsException - 索引が(index < 0 || index >= size())の範囲外であるかどうか

add

public boolean add(E e)

リストの最後に、指定された要� を追� します。

定義:

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

定義:

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

オーバーライド:

add、クラスAbstractList<E>

パラメータ:

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

戻り値:

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

add

public void add(int index, E element)

リスト内の指定された位置に指定された要� を挿入します。 その位置とそれ以降に要� があればそれらを右に移動させ、各要� のインデックスに1を� えます。

定義:

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

オーバーライド:

add、クラスAbstractList<E>

パラメータ:

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

element - 挿入される要�

スロー:

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

addFirst

public void addFirst(E element)

このコレクションの最初の要� として要� を追� します (オプションの操作)。 この操作が正常に完了すると、指定された要� はこのコレクションのメンバーになり、発生� �に最初の要� になります。

定義:

インタフェースList<E>内のaddFirst

定義:

インタフェースSequencedCollection<E>内のaddFirst

パラメータ:

element - 追� する要�

導入されたバージョン:

21

addLast

public void addLast(E element)

このコレクションの最後の要� として要� を追� します (オプションの操作)。 この操作が正常に完了すると、指定された要� はこのコレクションのメンバーになり、最後の要� が出現� �になります。

定義:

インタフェースList<E>内のaddLast

定義:

インタフェースSequencedCollection<E>内のaddLast

パラメータ:

element - 追� する要� 。

導入されたバージョン:

21

remove

public E remove(int index)

このリストの指定された位置にある要� を削除します。 後続の要� を左に移動します(インデックスから1を減算)。

定義:

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

オーバーライド:

remove、クラスAbstractList<E>

パラメータ:

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

戻り値:

リストから削除した要�

スロー:

IndexOutOfBoundsException - 索引が(index < 0 || index >= size())の範囲外であるかどうか

removeFirst

public E removeFirst()

このコレクションの最初の要� を削除して返します(オプションの操作)。

定義:

インタフェースList<E>内のremoveFirst

定義:

インタフェースSequencedCollection<E>内のremoveFirst

戻り値:

削除される要�

スロー:

NoSuchElementException - このコレクションが空の� �合

導入されたバージョン:

21

removeLast

public E removeLast()

このコレクションの最後の要� を削除して返します(オプションの操作)。

定義:

インタフェースList<E>内のremoveLast

定義:

インタフェースSequencedCollection<E>内のremoveLast

戻り値:

削除される要�

スロー:

NoSuchElementException - このコレクションが空の� �合

導入されたバージョン:

21

equals

public boolean equals(Object o)

指定されたオブジェクトがこのリストと等しいかどうかを比較します。 指定されたオブジェクトもリストであり、サイズが同じで、2つのリストの対応する要� がすべて等しい� �合に� けtrueを返します。 (e1==null ? e2==null : e1.equals(e2))の� �合、2つの要� e1とe2は等しくなります。 つまり2つのリストは、同じ要� が同じ� �序で含まれている� �合に等しいものとして定義されます。

定義:

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

定義:

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

オーバーライド:

equals、クラスAbstractList<E>

パラメータ:

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

戻り値:

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

関連� �目:

• Object.equals(Object)
• Set.equals(Object)
• List.equals(Object)

hashCode

public int hashCode()

このリストのハッシュ・コード値を返します。

定義:

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

定義:

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

オーバーライド:

hashCode、クラスAbstractList<E>

戻り値:

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

関連� �目:

• Object.hashCode()
• Object.equals(Object)

remove

public boolean remove(Object o)

指定された要� がこのリストにあれば、その最初のものをリストから削除します。 その要� がリストにない� �合、変更はありません。 より正式には、Objects.equals(o, get(i)) (そのような要� が存在する� �合)のように、最も低い索引iを持つ要� を削除します。 指定された要� がこのリストに含まれていた� �合、つまり、呼出しの結果としてこのリストが変更された� �合にtrueを返します。

定義:

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

定義:

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

オーバーライド:

remove、クラスAbstractCollection<E>

パラメータ:

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

戻り値:

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

clear

public void clear()

このリストからすべての要� を削除します。 この呼出しが戻ると、このリストは空になります。

定義:

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

定義:

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

オーバーライド:

clear、クラスAbstractList<E>

addAll

public boolean addAll(Collection<? extends E> c)

指定されたコレクション内のすべての要� を、指定されたコレクションのイテレータによって返される� �序でリストの最後に追� します。 オペレーションの進行中に、指定されたコレクションが変更された� �合の、このオペレーションの動作は定義されていません。 (つまり、指定されたコレクションがこのリスト自身であり、リストが空でない� �合、この呼出しの動作は保証されません。)

定義:

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

定義:

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

オーバーライド:

addAll、クラスAbstractCollection<E>

パラメータ:

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

戻り値:

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

スロー:

NullPointerException - 指定されたコレクションがnullである� �合

関連� �目:

• AbstractCollection.add(Object)

addAll

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

指定されたコレクション内のすべての要� を、リストの指定された位置に挿入します。 その位置とそれ以降に要� がある� �合は、それらを右に移動して、各要� のインデックスに1を� えます。 新しい要� は、指定されたコレクションのイテレータによって返される� �番でリストに挿入されます。

定義:

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

オーバーライド:

addAll、クラスAbstractList<E>

パラメータ:

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

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

戻り値:

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

スロー:

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

NullPointerException - 指定されたコレクションがnullである� �合

removeRange

protected void removeRange(int fromIndex, int toIndex)

fromIndex (これを含む)からtoIndex (これを含まない)の範囲のインデックスを持つすべての要� をこのリストから削除します。 後続の要� は左に移動します(インデックス値が減少)。 この呼出しにより、(toIndex - fromIndex)の要� 数� けリストが短くなります。 toIndex==fromIndexの� �合、このオペレーションは何も行いません。

オーバーライド:

removeRange、クラスAbstractList<E>

パラメータ:

fromIndex - 削除する最初の要� のインデックス

toIndex - 削除する最後の要� の直後のインデックス

スロー:

IndexOutOfBoundsException - fromIndexまたはtoIndexが範囲外の� �合(fromIndex < 0 || toIndex > size() || toIndex < fromIndex)

removeAll

public boolean removeAll(Collection<?> c)

リストから、指定されたコレクション内に保持されているすべての要� を削除します。

定義:

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

定義:

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

オーバーライド:

removeAll、クラスAbstractCollection<E>

パラメータ:

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

戻り値:

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

スロー:

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

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

関連� �目:

• Collection.contains(Object)

retainAll

public boolean retainAll(Collection<?> c)

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

定義:

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

定義:

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

オーバーライド:

retainAll、クラスAbstractCollection<E>

パラメータ:

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

戻り値:

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

スロー:

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

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

関連� �目:

• Collection.contains(Object)

listIterator

public ListIterator<E> listIterator(int index)

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

返されるリスト・イテレータは、フェイルファストです。

定義:

listIterator、インタフェースList<E>

オーバーライド:

listIterator、クラスAbstractList<E>

パラメータ:

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

戻り値:

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

スロー:

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

listIterator

public ListIterator<E> listIterator()

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

返されるリスト・イテレータは、フェイルファストです。

定義:

listIterator、インタフェースList<E>

オーバーライド:

listIterator、クラスAbstractList<E>

戻り値:

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

関連� �目:

• listIterator(int)

iterator

public Iterator<E> iterator()

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

返されるイテレータは、フェイルファストです。

定義:

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

定義:

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

定義:

iterator、インタフェースList<E>

オーバーライド:

iterator、クラスAbstractList<E>

戻り値:

リスト内の要� を適切な� �序で反復するイテレータ

subList

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

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

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

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

indexOf(Object)およびlastIndexOf(Object)でも、同様の慣用法を作成できます。Collectionsクラスのアルゴリズ� がすべてsubListに適用できます。

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

定義:

subList、インタフェースList<E>

オーバーライド:

subList、クラスAbstractList<E>

パラメータ:

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

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

戻り値:

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

スロー:

IndexOutOfBoundsException - 端点のインデックス値が範囲外の� �合(fromIndex < 0||toIndex> size)

IllegalArgumentException - 端点のインデックスの� �番が正しくない� �合(fromIndex> toIndex)

forEach

public void forEach(Consumer<? super E> action)

インタフェースからコピーされた説明: Iterable

Iterableの各要� に対して指定されたアクションを、すべての要� が処理されるか、アクションが例外をスローするまで実行します。 反復の� �序でアクションが実行されます(その� �序が指定されている� �合)。 アクションによってスローされた例外は、呼出し側に中継されます。

このメソッドの動作は、オーバーライドするクラスが同時変更ポリシーを指定していないかぎり、要� の基礎となるソースを変更する副作用をアクションが実行する� �合には指定されません。

定義:

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

パラメータ:

action - 各要� に対して実行されるアクション

スロー:

NullPointerException - 指定されたアクションがnullである� �合

spliterator

public Spliterator<E> spliterator()

このリスト内の要� に対する遅延バインディングおよびフェイルファスト Spliteratorを作成します。

Spliteratorは、Spliterator.SIZED、Spliterator.SUBSIZED、およびSpliterator.ORDEREDを� �告します。 オーバーライドする実装は、追� の特性値の� �告をドキュメント化する必要があります。

定義:

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

定義:

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

定義:

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

戻り値:

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

導入されたバージョン:

1.8

removeIf

public boolean removeIf(Predicate<? super E> filter)

次のインタフェースからコピーされた説明: Collection

指定された述語(オプションの操作)を満たす、このコレクションのすべての要� を削除します。 反復中に、または述語によってスローされたエラーまたは実行時例外は、呼出し側に中継されます。

定義:

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

パラメータ:

filter - 削除される要� に対してtrueを返す述語

戻り値:

要� が削除された� �合はtrue

スロー:

NullPointerException - 指定されたフィルタがnullである� �合