java.util
クラス ArrayList<E>

java.lang.Object
  java.util.ArrayList<E>

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

Iterable<E>, Collection<E>, List<E>

public class ArrayList<E>
extends Object
implements List<E>

ArrayList は List インタフェースを実装した、サイズを変更することの可能な配列です。

ArrayList は null を要素とすることができます。

コンストラクタの概要

ArrayList()
初期キャパシティ10の、空のリストを作成します。

ArrayList(int initialCapacity)
指定された初期キャパシティの空のリストを作成します。

メソッドの概要

boolean	add(E o) 指定された要素をこのリストの最後尾に追加します。
void	add(int index, E element) 指定されたインデックスに指定された要素を挿入します。
void	clear() リストから全ての要素を除去します。
boolean	contains(Object elem) 指定された要素がこのリストに含まれているかどうか判定します。
E	get(int index) 指定されたインデックスにある要素を返します。
int	indexOf(Object elem) 指定された要素がこのリストの中で最初に検出されるインデックスを返します。
boolean	isEmpty() このリストが空かどうかを判定します。
Iterator<E>	iterator() このリストの反復子を返します。
E	remove(int index) このリストの、指定されたインデックスの要素を除去します。
boolean	remove(Object o) このリストに指定されたオブジェクトが存在したらそれを一つ除去します。
E	set(int index, E element) このリストの指定されたインデックスにある要素を、指定された要素で入れ替えます。
int	size() このリストの要素の数を返します。
Object[]	toArray() このリストの全ての要素を、リストと同じ順に格納する配列を生成して返します。
String	toString() このリストの文字列表現を返します。
void	trimToSize() このリストのキャパシティを、このリストの要素をちょうど格納する大きさに削減します。

クラス java.lang.Object から継承されたメソッド

equals, getClass, hashCode, notify, notifyAll, wait, wait

コンストラクタの詳細

ArrayList

public ArrayList()

初期キャパシティ10の、空のリストを作成します。

ArrayList

public ArrayList(int initialCapacity)

指定された初期キャパシティの空のリストを作成します。

パラメータ:

initialCapacity - リストの初期キャパシティ

例外:

IllegalArgumentException - initialCapacity が負の場合

メソッドの詳細

add

public void add(int index,
                E element)

指定されたインデックスに指定された要素を挿入します。 指定されたインデックス以降に要素が既に存在する場合、それらは一つだけ後方に移動されます。

パラメータ:

index - 指定された要素を挿入するインデックス

element - 挿入する要素

例外:

IndexOutOfBoundsException - index が有効範囲にない場合 (index < 0 || index > size()) 。

add

public boolean add(E o)

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

定義:

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

パラメータ:

o - 追加する要素

戻り値:

Collection.add の規約に従い、true を返します。

clear

public void clear()

リストから全ての要素を除去します。 このメソッドが返った時点でリストは空になっています。

定義:

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

contains

public boolean contains(Object elem)

指定された要素がこのリストに含まれているかどうか判定します。

定義:

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

パラメータ:

elem - 判定対象の要素

戻り値:

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

get

public E get(int index)

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

定義:

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

パラメータ:

index - 要素のインデックス

戻り値:

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

例外:

IndexOutOfBoundsException - index が有効範囲にない場合 (index < 0 || index >= size()) 。

indexOf

public int indexOf(Object elem)

指定された要素がこのリストの中で最初に検出されるインデックスを返します。 リストの要素 e のうち elem.equals(e) が true である最初の e のインデックスが返されます。 ただし、elem が null の場合は、null である最初の要素のインデックスが返されます。

定義:

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

パラメータ:

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

戻り値:

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

isEmpty

public boolean isEmpty()

このリストが空かどうかを判定します。

定義:

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

戻り値:

このリストが空の場合 true、空でない場合 false

iterator

public Iterator<E> iterator()

このリストの反復子を返します。 この反復子は Iterator.hasNext() メソッドと Iterator.next() メソッドをサポートしていますが、Iterator.remove() メソッドはサポートしていません。

定義:

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

定義:

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

戻り値:

このリストの反復子

関連項目:

Collection.iterator()

remove

public E remove(int index)

このリストの、指定されたインデックスの要素を除去します。 指定されたインデックス + 1 以降に要素が存在する場合、それらの要素は一つだけ前方に移動されます。

定義:

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

パラメータ:

index - 除去する要素のインデックス

戻り値:

除去された要素

例外:

IndexOutOfBoundsException - index が有効な範囲にない場合 (index < 0 || index >= size()) 。

remove

public boolean remove(Object o)

このリストに指定されたオブジェクトが存在したらそれを一つ除去します。 このリストの要素 e について (o==null ? e==null : o.equals(e)) が成立する e が存在したら、リストから除去されます。 また、除去された要素の後方にある要素は一つだけ前方に移動されます。

定義:

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

パラメータ:

o - 除去するオブジェクト

戻り値:

要素が除去された場合 true、除去されなかった場合 false

set

public E set(int index,
             E element)

このリストの指定されたインデックスにある要素を、指定された要素で入れ替えます。

定義:

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

パラメータ:

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

element - 新たに要素として設定するオブジェクト

戻り値:

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

例外:

IndexOutOfBoundsException - index が有効な範囲にない場合 (index < 0 || index >= size()) 。

size

public int size()

このリストの要素の数を返します。

定義:

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

戻り値:

このリストの要素の数

toArray

public Object[] toArray()

このリストの全ての要素を、リストと同じ順に格納する配列を生成して返します。

定義:

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

戻り値:

このリストの全ての要素を、リストと同じ順に格納する配列

trimToSize

public void trimToSize()

このリストのキャパシティを、このリストの要素をちょうど格納する大きさに削減します。

toString

public String toString()

このリストの文字列表現を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

このリストの文字列表現