java.util
クラス Vector<E>

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

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

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

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

Stack

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

Vector クラスはメンバの数を増減させることの可能な List を実装しています。

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

Vector クラスの実装は内部同期されており、スレッドセーフです。 すなわち、複数のスレッドから同時並行的に同一の Vector を操作（メソッド呼び出し）してもその内部状態の整合性は保持されます。 これは、個々のメソッド単位の操作では整合性が保たれるという意味です。 もし一連のメソッド呼び出しにわたって別スレッドからの干渉を防ぐ必要がある場合は外部同期が必要です。

なお、iterator メソッドで得られる Iterator および elements メソッドで得られる Enumeration は fail-fast です。 すなわち、それらを取得した後に本体の Vector が変更された場合、 Iterator または Enumeration のメソッドが呼ばれると ConcurrentModificationException をスローします。 しかし変更の検出は best-effort で行われ、確実に検出することを保証するわけではありません。 したがって、並行して非同期に Vector の内容が変更される状況下では iterator および elements は使うべきではなく、上記の fail-fast な振る舞いはデバッグ時に参照する情報にとどめるのが適切です。

コンストラクタの概要

Vector()
初期容量 10 の、空の Vector オブジェクトを生成します。

Vector(int initialCapacity)
指定された初期容量の、空の Vector オブジェクトを生成します。

メソッドの概要

boolean	add(E o) 指定された要素をこの Vector オブジェクトの最後尾に追加します。
void	add(int index, E element) 指定されたインデックスに指定された要素を挿入します。
void	addElement(E obj) 指定された要素をこの Vector オブジェクトの最後尾に追加します。
void	clear() この Vector から全ての要素を除去します。
boolean	contains(Object elem) この Vector が指定された要素を含んでいたら true を返します。
void	copyInto(Object[] anArray) この Vector の要素を指定された配列にコピーします。
E	elementAt(int index) 指定されたインデックスにある要素を返します。
Enumeration<E>	elements() この Vector の要素を列挙する Enumeration を返します。
E	firstElement() この Vector の最初の要素を返します。
E	get(int index) この Vector の、指定されたインデックスにある要素を返します。
int	indexOf(Object elem) 指定されたオブジェクトがこの Vector で最初に検出された位置のインデックスを返します。
void	insertElementAt(E obj, int index) 指定されたインデックスに指定された要素を挿入します。
boolean	isEmpty() この Vector が空であるかどうかを判定します。
Iterator<E>	iterator() この Vector の要素を反復する Iterator を返します。
E	remove(int index) この Vector の、指定されたインデックスにある要素を除去して返します。
boolean	remove(Object o) この Vector の要素を一つ除去します。
void	removeElementAt(int index) この Vector の、指定されたインデックスにある要素を除去します。
E	set(int index, E element) この Vector の、指定されたインデックスにある要素を、指定された要素に入れ替えます。
void	setSize(int newSize) この Vector のサイズを設定します。
int	size() この Vector の要素の数を返します。
Object[]	toArray() この Vector の要素を同じ順に格納する配列を生成して返します。

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

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

コンストラクタの詳細

Vector

public Vector()

初期容量 10 の、空の Vector オブジェクトを生成します。

Vector

public Vector(int initialCapacity)

指定された初期容量の、空の Vector オブジェクトを生成します。

パラメータ:

initialCapacity - 初期容量

例外:

IllegalArgumentException - initialCapacity が負値の場合

メソッドの詳細

add

public void add(int index,
                E element)

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

パラメータ:

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

element - 挿入する要素

例外:

ArrayIndexOutOfBoundsException - index が有効な範囲外の場合 (index < 0 || index > size())

add

public boolean add(E o)

指定された要素をこの Vector オブジェクトの最後尾に追加します。

定義:

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

パラメータ:

o - 追加する要素

戻り値:

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

clear

public void clear()

この Vector から全ての要素を除去します。 例外がスローされなければ、この呼び出しから返った時点でこの Vector は空になっています。

定義:

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

contains

public boolean contains(Object elem)

この Vector が指定された要素を含んでいたら true を返します。 次の式が true である e が少なくとも一つこの Vector に存在したら true、そうでなければ false を返します。

(elem==null ? e==null :elem.equals(e))

定義:

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

パラメータ:

elem - この Vector の要素であるかどうかを判定するオブジェクト

戻り値:

この Vector が指定された要素を含んでいたら true

get

public E get(int index)

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

定義:

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

パラメータ:

index - 要素のインデックス

戻り値:

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

例外:

ArrayIndexOutOfBoundsException - index が有効な範囲外の場合 (index < 0 || index >= size())

indexOf

public int indexOf(Object elem)

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

(elem == null ? elementData[i] == null : elem.equals(elementData[i])) が true である最小のインデックス i が返されます。

定義:

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

パラメータ:

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

戻り値:

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

isEmpty

public boolean isEmpty()

この Vector が空であるかどうかを判定します。

定義:

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

戻り値:

この Vector が空である場合 true、そうでない場合 false

iterator

public Iterator<E> iterator()

この Vector の要素を反復する Iterator を返します。 この Iterator は、Vector の要素をインデックス順に反復します。 また、この Iterator は Iterator.remove() メソッドをサポートしておらず、 UnsupportedOperationException をスローします。

定義:

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

定義:

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

戻り値:

この Vector の要素を反復する Iterator

remove

public E remove(int index)

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

定義:

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

パラメータ:

index - 要素のインデックス

戻り値:

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

例外:

ArrayIndexOutOfBoundsException - index が有効な範囲外の場合 (index < 0 || index >= size())

remove

public boolean remove(Object o)

この Vector の要素を一つ除去します。 (o == null ? elementData[i] == null : o.equals(elementData[i])) が true である最小のインデックス i にある要素を除去し true を返します。 また、i＋1 以降にあるすべての要素を一つ前方に移動します。

定義:

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

パラメータ:

o - このコレクションに存在する場合に除去する要素

戻り値:

このコレクションから指定された要素が除去された場合 true 、 それ以外は false

set

public E set(int index,
             E element)

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

定義:

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

パラメータ:

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

element - 新しい要素

戻り値:

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

例外:

ArrayIndexOutOfBoundsException - index の値が有効な範囲の値でない場合 (index < 0 || index >= size())

size

public int size()

この Vector の要素の数を返します。

定義:

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

戻り値:

この Vector の要素の数

toArray

public Object[] toArray()

この Vector の要素を同じ順に格納する配列を生成して返します。

定義:

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

戻り値:

この Vector の要素を同じ順に格納した配列

addElement

public void addElement(E obj)

指定された要素をこの Vector オブジェクトの最後尾に追加します。

パラメータ:

obj - 追加する要素

firstElement

public E firstElement()

この Vector の最初の要素を返します。

戻り値:

この Vector の最初の要素

例外:

NoSuchElementException - この Vector が空の場合

elementAt

public E elementAt(int index)

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

このメソッドの機能は get(int) と同じです。

パラメータ:

index - 要素のインデックス

戻り値:

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

例外:

ArrayIndexOutOfBoundsException - index が有効な範囲外の場合 (index < 0 || index >= size())

removeElementAt

public void removeElementAt(int index)

この Vector の、指定されたインデックスにある要素を除去します。 また、除去された要素の後方にあるすべての要素を一つ前方に移動します。

このメソッドの機能は、戻り値の有無を除いて remove(int) と同じです。

パラメータ:

index - 要素のインデックス

例外:

ArrayIndexOutOfBoundsException - index が有効な範囲外の場合 (index < 0 || index >= size())

insertElementAt

public void insertElementAt(E obj,
                            int index)

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

このメソッドの機能は、戻り値の有無を除いて add(int, Object) と同じです。

パラメータ:

obj - 挿入する要素

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

例外:

ArrayIndexOutOfBoundsException - index が有効な範囲外の場合 (index < 0 || index > size())

setSize

public void setSize(int newSize)

この Vector のサイズを設定します。

newSize が現在の有効な要素の数（ elementCount ）より小さい場合、後方にある elementCount-newSize の数の要素は廃棄されます。 elementData[newSize] から elementData[elementCount-1] まで null を設定し、かつ elementCount の値を newSize に変更します。

newSize がこの Vector の配列のサイズ（ elementData.length ）より大きい場合、サイズが newSize である配列を新たに生成してこの Vector の有効な要素をコピーして、要素が格納されなかった場所には null を設定し、Vector の配列として設定します。

パラメータ:

newSize - 設定するサイズ

例外:

ArrayIndexOutOfBoundsException - newSize が負の場合

elements

public Enumeration<E> elements()

この Vector の要素を列挙する Enumeration を返します。 この Enumeration は、Vector の要素をインデックス順に列挙します。

戻り値:

この Vector の要素を列挙する Enumeration

copyInto

public void copyInto(Object[] anArray)

この Vector の要素を指定された配列にコピーします。 この Vector の要素をインデックス順に指定された配列にコピーします。

パラメータ:

anArray - コピー先の配列

例外:

NullPointerException - anArray が null の場合

IndexOutOfBoundsException - anArray のサイズが Vector の要素数より小さい場合（ anArray.length < elementCount )