java.util
インタフェース List<E>

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

Collection<E>, Iterable<E>

既知の実装クラスの一覧:

ArrayList, Stack, Vector

public interface List<E>
extends Collection<E>

List インタフェースは、Collection の個々の要素をその位置を示すインデックスでアクセス可能にします。

メソッドの概要

E	get(int index) この List の、指定されたインデックスにある要素を返します。
int	indexOf(Object obj) 指定されたオブジェクトがこのリスト中で最初に検出された位置のインデックスを返します。
E	remove(int index) この List の、指定されたインデックスにある要素を除去して返します（オプション）。
E	set(int index, E element) この List の、指定されたインデックスにある要素を、指定された要素に入れ替えます（オプション）。

インタフェース java.util.Collection から継承されたメソッド

add, clear, contains, isEmpty, iterator, remove, size, toArray

メソッドの詳細

get

E get(int index)

この List の、指定されたインデックスにある要素を返します。

パラメータ:

index - 要素のインデックス

戻り値:

この List の、指定されたインデックスにある要素

例外:

IndexOutOfBoundsException - index の値が有効な範囲内の値でない場合

remove

E remove(int index)

この List の、指定されたインデックスにある要素を除去して返します（オプション）。 また、除去された要素の後方にあるすべての要素は前方一つ移動されます。

パラメータ:

index - 要素のインデックス

戻り値:

この List の、指定されたインデックスにある要素

例外:

IndexOutOfBoundsException - index の値が有効な範囲内の値でない場合

UnsupportedOperationException - このリストでは remove メソッドがサポートされていない場合

set

E set(int index,
      E element)

この List の、指定されたインデックスにある要素を、指定された要素に入れ替えます（オプション）。 以前の要素はリストから除去されて返されます。

パラメータ:

index - 入れ替える要素のインデックス

element - 新しい要素

戻り値:

このListの、指定されたインデックスに存在していた以前の要素

例外:

UnsupportedOperationException - このリストでは set メソッドがサポートされていない場合

ClassCastException - element に指定されたオブジェクトをこのリストの要素の型にキャストできない場合

NullPointerException - element に指定されたオブジェクトが null で、このリストが null を要素としてサポートしていない場合

IllegalArgumentException - element に指定されたオブジェクトが、その性質上このリストの要素として格納できない場合

IndexOutOfBoundsException - index の値が有効な範囲内の値でない場合

indexOf

int indexOf(Object obj)

指定されたオブジェクトがこのリスト中で最初に検出された位置のインデックスを返します。 存在していない場合、-1 を返します。

パラメータ:

obj - 検索するオブジェクト

戻り値:

指定されたオブジェクトが最初に検出された位置のインデックス。 検出されなかった場合、-1。

例外:

ClassCastException - obj に指定されたオブジェクトをこのリストの要素の型にキャストできない場合（オプション）

NullPointerException - obj に指定されたオブジェクトが null で、このリストが null を要素としてサポートしていない場合（オプション）