モジュール java.base

パッケージ java.util.concurrent

クラスCopyOnWriteArrayList<E>

java.lang.Object

java.util.concurrent.CopyOnWriteArrayList<E>

型パラメータ:

E - このリストに保持されている要素の型

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

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

public class CopyOnWriteArrayList<E> extends Object implements List<E>, RandomAccess, Cloneable, Serializable

基になる配列の新しいコピーを作成することにより、すべての推移的操作(add、setなど)が実装されるArrayListのスレッドセーフな変数です。

通常、これは非常に効率が悪いのですが、トラバーサル操作が変更を数の点で大幅に上回る場合には、代替手段よりも効率が良い場合があります。また、これは、トラバーサルを同期できない場合や、同期することを望まないが、並行スレッド間の干渉を排除する必要がある場合に有用です。 「スナップショット」スタイルのイテレータ・メソッドは、イテレータの作成時点での配列状態への参照を使用します。 この配列がイテレータの有効期間中に変更されることは決してないため、干渉は不可能であり、イテレータはConcurrentModificationExceptionをスローしないことが保証されます。 イテレータは、イテレータの作成以降のリストへの追加、削除、または変更を反映しません。 イテレータ自体に対する要素変更操作(remove、setおよびadd)はサポートされません。 これらのメソッドは、UnsupportedOperationExceptionをスローします。

nullを含むすべての要素が許可されます。

メモリー整合性効果: ほかの並行処理コレクションと同様、オブジェクトをCopyOnWriteArrayListに配置する前のスレッド内のアクションは、別のスレッドでのその要素へのアクセスまたはCopyOnWriteArrayListからの削除に続くアクションよりも前に発生します。

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

導入されたバージョン:

1.5

関連項目:

• 直列化された形式

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

コンストラクタ

コンストラクタ	説明
CopyOnWriteArrayList()	空のリストを作成します。
CopyOnWriteArrayList(E[] toCopyIn)	指定された配列のコピーを保持するリストを作成します。
CopyOnWriteArrayList(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)	指定されたコレクション内のすべての要素を、指定されたコレクションのイテレータによって返される順序でこのリストの最後に追加します。
int	addAllAbsent(Collection<? extends E> c)	このリストに含まれていない、指定されたコレクション内のすべての要素を、指定されたコレクションのイテレータによって返される順序でこのリストの最後に追加します。
void	addFirst(E e)	このコレクションの最初の要素として要素を追加します (オプションの操作)。
boolean	addIfAbsent(E e)	要素が存在しない場合、要素を追加します。
void	addLast(E e)	このコレクションの最後の要素として要素を追加します (オプションの操作)。
void	clear()	このリストからすべての要素を削除します。
Object	clone()	このリストのシャロー・コピーを返します。
boolean	contains(Object o)	指定された要素がこのリストに含まれている場合にtrueを返します。
boolean	containsAll(Collection<?> c)	指定されたコレクションのすべての要素がこのリストに含まれている場合にtrueを返します。
boolean	equals(Object o)	指定されたオブジェクトがこのリストと等しいかどうかを比較します。
void	forEach(Consumer<? super E> action)	Iterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。
E	get(int index)	このリスト内の指定された位置にある要素を返します。
E	getFirst()	このコレクションの最初の要素を取得します。
E	getLast()	このコレクションの最後の要素を取得します。
int	hashCode()	このリストのハッシュ・コード値を返します。
int	indexOf(E e, int index)	指定された要素をリスト内でindexから検索して最初に検出された位置のインデックスを返します。要素が見つからない場合は -1を返します。
int	indexOf(Object o)	指定された要素がこのリスト内で最初に検出された位置のインデックスを返します。指定された要素がこのリストにない場合は -1を返します。
boolean	isEmpty()	このリストに要素がない場合にtrueを返します。
Iterator<E>	iterator()	このリスト内の要素を適切な順序で反復するイテレータを返します。
int	lastIndexOf(E e, int index)	指定された要素をリスト内でindexから後向きに検索して最後に検出された位置のインデックスを返します。要素が見つからない場合は -1を返します。
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()	このコレクションの最後の要素を削除して返します(オプションの操作)。
boolean	retainAll(Collection<?> c)	指定されたコレクション内に保持されている、リスト内の要素だけを保持します。
List<E>	reversed()	このコレクションの逆順viewを返します。
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)	このリスト内のすべての要素を適切な順序で(最初の要素から最後の要素へ)含んでいる配列を返します。返される配列の実行時の型は、指定された配列の型になります。
String	toString()	このリストの文字列表現を返します。

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

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

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

parallelStream, stream, toArray

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

replaceAll, sort

コンストラクタの詳細

CopyOnWriteArrayList

public CopyOnWriteArrayList()

空のリストを作成します。

CopyOnWriteArrayList

public CopyOnWriteArrayList(Collection<? extends E> c)

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

パラメータ:

c - 最初に保持されていた要素のコレクション

例外:

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

CopyOnWriteArrayList

public CopyOnWriteArrayList(E[] toCopyIn)

指定された配列のコピーを保持するリストを作成します。

パラメータ:

toCopyIn - 配列(この配列のコピーが内部配列として使用される)

例外:

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

メソッドの詳細

size

public int size()

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

定義:

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

定義:

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

戻り値:

このリスト内の要素数

isEmpty

public boolean isEmpty()

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

定義:

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

定義:

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

戻り値:

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

contains

public boolean contains(Object o)

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

定義:

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

定義:

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

パラメータ:

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

戻り値:

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

indexOf

public int indexOf(Object o)

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

定義:

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

パラメータ:

o - 検索する要素

戻り値:

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

indexOf

public int indexOf(E e, int index)

指定された要素をリスト内でindexから検索して最初に検出された位置のインデックスを返します。要素が見つからない場合は -1を返します。 より正式には、i >= index && Objects.equals(get(i), e)のように最も低い索引iを戻し、そのような索引がない場合は -1を戻します。

パラメータ:

e - 検索する要素

index - 検索開始位置のインデックス

戻り値:

このリスト内のindex以降の位置で、要素がリスト内で最初に現れる位置のインデックス。要素が見つからない場合は-1。

例外:

IndexOutOfBoundsException - 指定されたインデックスが負の値の場合

lastIndexOf

public int lastIndexOf(Object o)

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

定義:

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

パラメータ:

o - 検索する要素

戻り値:

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

lastIndexOf

public int lastIndexOf(E e, int index)

指定された要素をリスト内でindexから後向きに検索して最後に検出された位置のインデックスを返します。要素が見つからない場合は -1を返します。 より正式には、i <= index && Objects.equals(get(i), e)のように最も高い索引iを戻し、そのような索引がない場合は -1を戻します。

パラメータ:

e - 検索する要素

index - 逆方向の検索開始位置のインデックス

戻り値:

このリスト内のindex以前の位置で、要素がリスト内で最後に現れる位置のインデックス。要素が見つからない場合は -1。

例外:

IndexOutOfBoundsException - 指定されたインデックスが、このリストの現在のサイズに等しいかそれよりも大きい場合

clone

public Object clone()

このリストのシャロー・コピーを返します。 要素自体はコピーされません。

オーバーライド:

clone、クラスObject

戻り値:

このリストの複製

関連項目:

• Cloneable

toArray

public Object[] toArray()

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

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

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

定義:

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

定義:

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

戻り値:

リスト内のすべての要素を保持している配列

関連項目:

• Arrays.asList(Object[])

toArray

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

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

リストが指定された配列に収まり、その配列にさらに余裕がある場合(つまり、配列がリストより多くの要素を持つ場合)、その配列内でリストの終端よりあとの要素はnullに設定されます。 (これは、呼出し側がこのリストにnull要素が1つも含まれていないことがわかっている場合にのみ、このリストの長さを判定するのに役立ちます。)

toArray()メソッドと同じように、このメソッドは、配列ベースのAPIとコレクションベースのAPIの間の橋渡し役として機能します。 さらに、このメソッドでは出力配列の実行時の型を正確に制御できるため、環境によっては割当ての手間を抑えるために使用できます。

xが、文字列だけからなるリストであることがわかっていると仮定します。 次のコードを使うと、新しく割り当てられたStringの配列にリストをダンプできます。

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

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

定義:

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

定義:

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

型パラメータ:

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

パラメータ:

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

戻り値:

リスト内のすべての要素を保持している配列

例外:

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

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

get

public E get(int index)

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

定義:

get、インタフェースList<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>

パラメータ:

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

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

戻り値:

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

例外:

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

add

public boolean add(E e)

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

定義:

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

定義:

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

パラメータ:

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

戻り値:

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

add

public void add(int index, E element)

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

定義:

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

パラメータ:

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

element - 挿入される要素

例外:

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

addFirst

public void addFirst(E e)

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

定義:

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

定義:

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

パラメータ:

e - 追加する要素

導入されたバージョン:

21

addLast

public void addLast(E e)

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

定義:

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

定義:

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

パラメータ:

e - 追加する要素。

導入されたバージョン:

21

remove

public E remove(int index)

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

定義:

remove、インタフェースList<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

remove

public boolean remove(Object o)

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

定義:

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

定義:

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

パラメータ:

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

戻り値:

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

addIfAbsent

public boolean addIfAbsent(E e)

要素が存在しない場合、要素を追加します。

パラメータ:

e - このリストに追加される要素(要素が存在しない場合)

戻り値:

要素が追加された場合はtrue

containsAll

public boolean containsAll(Collection<?> c)

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

定義:

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

定義:

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

パラメータ:

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

戻り値:

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

例外:

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

関連項目:

• contains(Object)

removeAll

public boolean removeAll(Collection<?> c)

リストから、指定されたコレクション内に保持されているすべての要素を削除します。 これは、内部に一時配列が必要になるため、このクラス内で特に負荷の大きい動作です。

定義:

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

定義:

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

パラメータ:

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

戻り値:

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

例外:

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

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

関連項目:

• remove(Object)

retainAll

public boolean retainAll(Collection<?> c)

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

定義:

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

定義:

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

パラメータ:

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

戻り値:

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

例外:

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

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

関連項目:

• remove(Object)

addAllAbsent

public int addAllAbsent(Collection<? extends E> c)

このリストに含まれていない、指定されたコレクション内のすべての要素を、指定されたコレクションのイテレータによって返される順序でこのリストの最後に追加します。

パラメータ:

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

戻り値:

追加される要素の数

例外:

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

関連項目:

• addIfAbsent(Object)

clear

public void clear()

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

定義:

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

定義:

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

addAll

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

指定されたコレクション内のすべての要素を、指定されたコレクションのイテレータによって返される順序でこのリストの最後に追加します。

定義:

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

定義:

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

パラメータ:

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

戻り値:

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

例外:

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

関連項目:

• add(Object)

addAll

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

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

定義:

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

パラメータ:

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

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

戻り値:

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

例外:

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

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

関連項目:

• add(int,Object)

forEach

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

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

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

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

定義:

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

パラメータ:

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

例外:

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

removeIf

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

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

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

定義:

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

パラメータ:

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

戻り値:

要素が削除された場合はtrue

例外:

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

toString

public String toString()

このリストの文字列表現を返します。 文字列表現は、リストの要素の文字列表現をそのイテレータが返した順に角括弧("[]")で囲んで示すリストです。 隣接する要素は、文字", " (カンマと空白文字)によって区切られます。 要素は、String.valueOf(Object)により文字列に変換されます。

オーバーライド:

toString、クラスObject

戻り値:

このリストの文字列表現

equals

public boolean equals(Object o)

指定されたオブジェクトがこのリストと等しいかどうかを比較します。 指定されたオブジェクトがこのオブジェクトと同じオブジェクトである場合、またはそれがListでもあり、指定されたリストでiteratorによって返された要素のシーケンスが、このリストでイテレータによって返されたシーケンスと同じである場合はtrueを返します。 この2つのシーケンスは、長さが同じで、シーケンス内の同じ位置にある対応する要素が等しい場合に同じであると見なされます。 e1とe2の2つの要素は、Objects.equals(e1, e2)の場合はequalとみなされます。

定義:

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

定義:

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

オーバーライド:

equals、クラスObject

パラメータ:

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

戻り値:

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

関連項目:

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

hashCode

public int hashCode()

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

この実装は、List.hashCode()内の定義を使用します。

定義:

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

定義:

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

オーバーライド:

hashCode、クラスObject

戻り値:

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

関連項目:

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

iterator

public Iterator<E> iterator()

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

返されるイテレータは、イテレータの構築時のリスト状態のスナップショットを提供します。 イテレータのトラバーサル中に同期化は必要ありません。 イテレータは、removeメソッドをサポートしません。

定義:

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

定義:

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

定義:

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

戻り値:

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

listIterator

public ListIterator<E> listIterator()

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

返されるイテレータは、イテレータの構築時のリスト状態のスナップショットを提供します。 イテレータのトラバーサル中に同期化は必要ありません。 イテレータは、remove、set、またはaddメソッドをサポートしません。

定義:

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

戻り値:

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

listIterator

public ListIterator<E> listIterator(int index)

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

返されるイテレータは、イテレータの構築時のリスト状態のスナップショットを提供します。 イテレータのトラバーサル中に同期化は必要ありません。 イテレータは、remove、set、またはaddメソッドをサポートしません。

定義:

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

パラメータ:

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

戻り値:

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

例外:

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

spliterator

public Spliterator<E> spliterator()

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

Spliteratorは、Spliterator.IMMUTABLE、Spliterator.ORDERED、Spliterator.SIZEDおよびSpliterator.SUBSIZEDを報告します。

スプリッテレータは、スプリッテレータが構築されたときのリスト状態のスナップショットを提供します。 スプリッテレータの操作中に同期化は必要ありません。

定義:

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

定義:

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

定義:

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

戻り値:

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

導入されたバージョン:

1.8

subList

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

このリストの、fromIndex (これを含む)とtoIndex (これを含まない)の間の部分のビューを返します。 返されるリストはこのリストに連動しているため、返されるリスト内の変更はこのリストに反映されます。

バッキング・リスト(つまり、このリスト)が、返されたリストを経由せずに変更された場合、このメソッドで返されたリストのセマンティックスは未定義になります。

定義:

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

パラメータ:

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

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

戻り値:

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

例外:

IndexOutOfBoundsException - 不正なエンドポイント索引値(fromIndex < 0 || toIndex > size || fromIndex > toIndex)

reversed

public List<E> reversed()

このコレクションの逆順viewを返します。 返されるビュー内の要素の出現順序は、このコレクション内の要素の出現順序の逆です。 逆の順序付けは、返されるビューのビュー・コレクションに含まれるすべての順序依存操作に影響します。 コレクション実装でこのビューの変更が許可されている場合、ベースとなるコレクションへの変更"ライトスルー"。 実装によっては、基礎となるコレクションに対する変更が、この逆方向ビューに表示される場合と表示されない場合があります。

戻し処理されたビューへの変更は許可され、このリストに伝播されます。 また、このリストへの変更は、逆方向ビューに表示されます。 逆方向ビューのサブリストとイテレータには、このリストのものと同じ制限があります。

定義:

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

定義:

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

戻り値:

このコレクションの逆順ビュー(Listとして)

導入されたバージョン:

21