java.util

クラス Vector<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.Vector<E>

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

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

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

Stack

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

Vector クラスは、オブジェクトの可変長配列を実装します。ここには配列と同じように、整数インデックスを使ってアクセスできる要素が格納されています。しかし、Vector のサイズは、Vector の作成後に追加および削除された項目を格納できるように必要に応じて増やしたり減らしたりすることができます。

各ベクトルは、capacity と capacityIncrement を維持することによって記憶領域の管理を最適化しようとします。capacity は常にベクトルのサイズ以上であり、通常はより大きくなります。これは、ベクトルにコンポーネントが追加されるとき、ベクトルの記憶領域は capacityIncrement ずつかたまりで増やされるからです。多くの要素を挿入する前にアプリケーションで容量を必要な値に設定しておけば、メモリーの再配分の回数を減らすことができます。

このクラスの iterator および listIterator メソッドによって返されるイテレータは、フェイルファストです。イテレータの作成後に、イテレータ自体の remove または add メソッド以外の方法でベクトルが構造的に変更されると、イテレータは ConcurrentModificationException をスローします。このように、並行して変更が行われると、イテレータは、将来の予測できない時点において予測できない動作が発生する危険を回避するために、ただちにかつ手際よく例外をスローします。elements メソッドが返す Enumerations は、フェイルファストではありません。

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

このクラスは、Java 2 プラットフォーム v1.2 の時点で List インタフェースを実装するように改良された結果、Java Collections Framework のメンバーとなりました。新しいコレクションの実装とは異なり、Vector は同期をとります。スレッドセーフな実装が必要ない場合は、Vector の代わりに ArrayList を使用することをお勧めします。

導入されたバージョン:

JDK1.0

関連項目:

Collection, LinkedList, 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
protected int	capacityIncrement Vector のサイズが Vector の容量を超えるときに自動的に増やされる量です。
protected int	elementCount この Vector オブジェクト内の有効なコンポーネントの数です。
protected Object[]	elementData Vector の要素が格納される配列バッファーです。

クラス java.util.AbstractList から継承されたフィールド

modCount

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

コンストラクタ

コンストラクタと説明
Vector() 空のベクトルを作成し、その内部データ配列のサイズが 10 で、その標準的な増分がゼロであるようにします。
Vector(Collection<? extends E> c) 指定されたコレクションのイテレータが返した順序で、その要素を格納する Vector を作成します。
Vector(int initialCapacity) 指定された初期容量、および増加量がゼロである、空のベクトルを作成します。
Vector(int initialCapacity, int capacityIncrement) 指定された容量と増加量で空のベクトルを作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
boolean	add(E e) Vector の末尾に指定の要素を追加します。
void	add(int index, E element) Vector 内の指定された位置に指定された要素を挿入します。
boolean	addAll(Collection<? extends E> c) 指定された Collection 内のすべての要素をこの Vector の末尾に、その Collection の Iterator によって返される順序で追加します。
boolean	addAll(int index, Collection<? extends E> c) 指定された Collection 内のすべての要素を、Vector の指定された位置に挿入します。
void	addElement(E obj) 指定された要素を Vector の最後に追加し、サイズを 1 増やします。
int	capacity() Vector の現在の容量を返します。
void	clear() すべての要素を Vector から削除します。
Object	clone() Vector をコピーします。
boolean	contains(Object o) 指定された要素がこのベクトルに含まれている場合に true を返します。
boolean	containsAll(Collection<?> c) Vector が指定の Collection 内のすべての要素を保持する場合に true を返します。
void	copyInto(Object[] anArray) Vector の要素を、指定された配列にコピーします。
E	elementAt(int index) 指定されたインデックスの要素を返します。
Enumeration<E>	elements() この Vector の要素を列挙したリストを返します。
void	ensureCapacity(int minCapacity) Vector の収容量を必要に応じて増やして、少なくとも最小収容量の引数で指定される要素数を保持できることを保証します。
boolean	equals(Object o) 指定された Object が Vector と等しいかどうかを比較します。
E	firstElement() このベクトルの最初のコンポーネント (インデックス 0 にある項目) を返します。
E	get(int index) Vector 内の指定された位置にある要素を返します。
int	hashCode() Vector のハッシュコード値を返します。
int	indexOf(Object o) 指定された要素がベクトル内で最初に検出された位置のインデックスを返します。指定された要素がベクトルにない場合は -1 を返します。
int	indexOf(Object o, int index) 指定された要素をこのベクトル内で index から順方向に検索して、最初に検出された位置のインデックスを返します。要素が見つからない場合は -1 を返します。
void	insertElementAt(E obj, int index) 指定されたオブジェクトを、このベクトル内の指定された index の位置にコンポーネントとして挿入します。
boolean	isEmpty() Vector が要素を持たないかどうかを判定します。
Iterator<E>	iterator() このリスト内の要素を適切な順序で反復するイテレータを返します。
E	lastElement() Vector の最後の要素を返します。
int	lastIndexOf(Object o) 指定された要素がベクトル内で最後に検出された位置のインデックスを返します。指定された要素がベクトルにない場合は -1 を返します。
int	lastIndexOf(Object o, int index) 指定された要素をこのベクトル内で index から逆方向に検索して、最後に検出された位置のインデックスを返します。要素が見つからない場合は -1 を返します。
ListIterator<E>	listIterator() このリスト内の要素を (適切な順序で) 反復するリストイテレータを返します。
ListIterator<E>	listIterator(int index) リスト内の指定された位置で始まる、リスト内の要素を (適切な順序で) 反復するリストイテレータを返します。
E	remove(int index) ベクトルの指定された位置にある要素を削除します。
boolean	remove(Object o) Vector 内で最初に検出された指定された要素を削除します。
boolean	removeAll(Collection<?> c) Vector から、指定された Collection 内に保持されているすべての要素を削除します。
void	removeAllElements() Vector からすべての要素を削除し、サイズを 0 に設定します。
boolean	removeElement(Object obj) 最初に検出された (最小インデックスの) 引数の要素を Vector から削除します。
void	removeElementAt(int index) 指定されたインデックスのコンポーネントを削除します。
protected void	removeRange(int fromIndex, int toIndex) fromIndex (これを含む) から toIndex (これを含まない) の範囲のインデックスを持つすべての要素をこのリストから削除します。
boolean	retainAll(Collection<?> c) 指定された Collection 内に保持されている、Vector 内の要素だけを保持します。
E	set(int index, E element) Vector 内の指定された位置にある要素を、指定の要素で置き換えます。
void	setElementAt(E obj, int index) このベクトルの指定された index にあるコンポーネントが指定されたオブジェクトになるように設定します。
void	setSize(int newSize) Vector のサイズを設定します。
int	size() Vector の要素数を返します。
List<E>	subList(int fromIndex, int toIndex) この List の、fromIndex (これを含む) と toIndex (これを含まない) の間の部分のビューを返します。
Object[]	toArray() Vector 内のすべての要素を正しい順序で保持する配列を返します。
<T> T[]	toArray(T[] a) Vector 内のすべての要素が正しい順序で格納されている配列を返します。返される配列の実行時の型は指定された配列の型になります。
String	toString() 各要素の String 表現を保持している、Vector の文字列表現を返します。
void	trimToSize() Vector の容量を、現在の容量にまで減らします。

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

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

フィールドの詳細

elementData

protected Object[] elementData

Vector の要素が格納される配列バッファーです。Vector の容量はこの配列バッファーの長さで、少なくとも Vector のすべての要素を格納するのに十分な大きさが必要です。

Vector 内の最後の要素の後に来る配列要素は null です。

elementCount

protected int elementCount

この Vector オブジェクト内の有効なコンポーネントの数です。elementData[0] から elementData[elementCount-1] までの要素が実際の項目となります。

capacityIncrement

protected int capacityIncrement

Vector のサイズが Vector の容量を超えるときに自動的に増やされる量です。容量の増加量がゼロ以下の場合、拡大の必要があるたびに Vector の容量は倍になります。

コンストラクタの詳細

Vector

public Vector(int initialCapacity,
      int capacityIncrement)

指定された容量と増加量で空のベクトルを作成します。

パラメータ:

initialCapacity - ベクトルの初期容量

capacityIncrement - ベクトルがオーバーフローした際の容量の増加量

例外:

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

Vector

public Vector(int initialCapacity)

指定された初期容量、および増加量がゼロである、空のベクトルを作成します。

パラメータ:

initialCapacity - ベクトルの初期容量

例外:

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

Vector

public Vector()

空のベクトルを作成し、その内部データ配列のサイズが 10 で、その標準的な増分がゼロであるようにします。

Vector

public Vector(Collection<? extends E> c)

指定されたコレクションのイテレータが返した順序で、その要素を格納する Vector を作成します。

パラメータ:

c - 要素がこのベクトルに配置されるコレクション

例外:

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

導入されたバージョン:

1.2

メソッドの詳細

copyInto

public void copyInto(Object[] anArray)

Vector の要素を、指定された配列にコピーします。このベクトル内のインデックス k の項目が、anArray のコンポーネント k にコピーされます。

パラメータ:

anArray - コピーしたコンポーネントをコピーする配列

例外:

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

IndexOutOfBoundsException - 指定された配列が小さすぎて、このベクトルのすべてのコンポーネントを格納できない場合

ArrayStoreException - このベクトルのあるコンポーネントが、指定された配列に格納できる実行時の型ではない場合

関連項目:

toArray(Object[])

trimToSize

public void trimToSize()

Vector の容量を、現在の容量にまで減らします。このベクトルの容量が現在のサイズよりも大きい場合、elementData フィールドに保持されているその内部データ配列を小さいものに置き換えることで、容量を現在のサイズに等しくなるように変更します。アプリケーションでこの操作を行うと Vector のメモリー使用量を最小にできます。

ensureCapacity

public void ensureCapacity(int minCapacity)

Vector の収容量を必要に応じて増やして、少なくとも最小収容量の引数で指定される要素数を保持できることを保証します。

このベクトルの現在の容量が minCapacity よりも小さい場合、elementData フィールドに保持されているその内部データ配列を大きいものに置き換えることで、容量を増やします。新しいデータ配列のサイズは、capacityIncrement がゼロ以下でないかぎり、元のサイズにその値を加えたものになります。capacityIncrement がゼロ以下の場合は新しい容量は元の容量の 2 倍になります。新しいサイズがまだ minCapacity よりも小さい場合には、新しい容量は minCapacity になります。

パラメータ:

minCapacity - 目的の最小容量

setSize

public void setSize(int newSize)

Vector のサイズを設定します。新しいサイズが現在のサイズより大きい場合は、新しい null 項目がベクトルの最後に追加されます。新しいサイズが現在のサイズより小さい場合、インデックス newSize 以降のすべてのコンポーネントが破棄されます。

パラメータ:

newSize - このベクトルの新しいサイズ

例外:

ArrayIndexOutOfBoundsException - 新しいサイズが負の値の場合

capacity

public int capacity()

Vector の現在の容量を返します。

戻り値:

現在の容量 (このベクトルの elementData フィールドに保持されている、その内部データ配列の長さ)

size

public int size()

Vector の要素数を返します。

定義:

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

定義:

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

定義:

size、クラス: AbstractCollection<E>

戻り値:

Vector の要素数

isEmpty

public boolean isEmpty()

Vector が要素を持たないかどうかを判定します。

定義:

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

定義:

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

オーバーライド:

isEmpty、クラス: AbstractCollection<E>

戻り値:

このベクトルがコンポーネントを持っていない場合、つまりサイズがゼロの場合にかぎり true、そうでない場合は false。

elements

public Enumeration<E> elements()

この Vector の要素を列挙したリストを返します。返される Enumeration オブジェクトは、このベクトルのすべての項目を生成します。最初に生成される項目はインデックス 0 の項目、次に生成される項目はインデックス 1 の項目、といった具合になります。

戻り値:

Vector の要素のリスト

関連項目:

Iterator

contains

public boolean contains(Object o)

指定された要素がこのベクトルに含まれている場合に true を返します。つまり、このベクトルに、(o==null ? e==null : o.equals(e)) となる要素 e が 1 つ以上含まれている場合にのみ true を返します。

定義:

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

定義:

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

オーバーライド:

contains、クラス: AbstractCollection<E>

パラメータ:

o - このベクトル内にあるかどうかが判定される要素

戻り値:

指定された要素がこのベクトルに含まれている場合は true

indexOf

public int indexOf(Object o)

指定された要素がベクトル内で最初に検出された位置のインデックスを返します。指定された要素がベクトルにない場合は -1 を返します。つまり、(o==null ? get(i)==null : o.equals(get(i))) となる、最小のインデックス i を返します。そのようなインデックスが存在しない場合は -1 を返します。

定義:

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

オーバーライド:

indexOf、クラス: AbstractList<E>

パラメータ:

o - 検索する要素

戻り値:

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

indexOf

public int indexOf(Object o,
          int index)

指定された要素をこのベクトル内で index から順方向に検索して、最初に検出された位置のインデックスを返します。要素が見つからない場合は -1 を返します。つまり、(i >= index && (o==null ? get(i)==null : o.equals(get(i)))) となる、最小のインデックス i を返します。そのようなインデックスが存在しない場合は -1 を返します。

パラメータ:

o - 検索する要素

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

戻り値:

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

例外:

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

関連項目:

Object.equals(Object)

lastIndexOf

public int lastIndexOf(Object o)

指定された要素がベクトル内で最後に検出された位置のインデックスを返します。指定された要素がベクトルにない場合は -1 を返します。つまり、(o==null ? get(i)==null : o.equals(get(i))) となる、最大のインデックス i を返します。そのようなインデックスが存在しない場合は -1 を返します。

定義:

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

オーバーライド:

lastIndexOf、クラス: AbstractList<E>

パラメータ:

o - 検索する要素

戻り値:

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

lastIndexOf

public int lastIndexOf(Object o,
              int index)

指定された要素をこのベクトル内で index から逆方向に検索して、最後に検出された位置のインデックスを返します。要素が見つからない場合は -1 を返します。つまり、(i <= index && (o==null ? get(i)==null : o.equals(get(i)))) となる、最大のインデックス i を返します。そのようなインデックスが存在しない場合は -1 を返します。

パラメータ:

o - 検索する要素

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

戻り値:

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

例外:

IndexOutOfBoundsException - 指定されたインデックスが、このベクトルの現在のサイズ以上である場合

elementAt

public E elementAt(int index)

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

このメソッドは機能的に get(int) メソッド (List インタフェースの一部) と同じです。

パラメータ:

index - このベクトルのインデックス

戻り値:

指定されたインデックスのコンポーネント

例外:

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

firstElement

public E firstElement()

このベクトルの最初のコンポーネント (インデックス 0 にある項目) を返します。

戻り値:

Vector の最初の要素

例外:

NoSuchElementException - このベクトルがコンポーネントを持たない場合

lastElement

public E lastElement()

Vector の最後の要素を返します。

戻り値:

ベクトルの最後のコンポーネント、すなわちインデックス size() - 1 のコンポーネント。

例外:

NoSuchElementException - このベクトルが空の場合

setElementAt

public void setElementAt(E obj,
                int index)

このベクトルの指定された index にあるコンポーネントが指定されたオブジェクトになるように設定します。そのインデックスにあった要素は破棄されます。

インデックスの値は、0 以上で、ベクトルの現在のサイズよりも小さくする必要があります。

このメソッドは機能的に set(int, E) メソッド (List インタフェースの一部) と同じです。配列の使い方により適した形にするために set メソッドがパラメータの順序を逆にすることに注意してください。また、set メソッドが指定された位置に格納されていた古い値を返すことにも注意してください。

パラメータ:

obj - コンポーネントに設定されるオブジェクト

index - 指定するインデックス

例外:

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

removeElementAt

public void removeElementAt(int index)

指定されたインデックスのコンポーネントを削除します。このベクトル内にある各コンポーネントのうち、指定された index と等しいか、それより大きいインデックスを持つものはすべて前方に移動し、そのインデックスの値は以前より 1 つ小さい値になります。このベクトルのサイズは 1 だけ減らされます。

インデックスの値は、0 以上で、ベクトルの現在のサイズよりも小さくする必要があります。

このメソッドは機能的に remove(int) メソッド (List インタフェースの一部) と同じです。remove メソッドが指定された位置に格納されていた古い値を返すことに注意してください。

パラメータ:

index - 削除されるオブジェクトのインデックス

例外:

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

insertElementAt

public void insertElementAt(E obj,
                   int index)

指定されたオブジェクトを、このベクトル内の指定された index の位置にコンポーネントとして挿入します。このベクトル内にある各コンポーネントのうち、指定された index と等しいか、それより大きいインデックスを持つものはすべて後方に移動し、そのインデックスの値は以前より 1 つ大きい値になります。

インデックスの値は、0 以上で、ベクトルの現在のサイズ以下にする必要があります。インデックスが Vector の現在のサイズに等しい場合、新しい要素は Vector の末尾に追加されます。

このメソッドは機能的に add(int, E) メソッド (List インタフェースの一部) と同じです。配列の使い方により適した形にするために add メソッドがパラメータの順序を逆にすることに注意してください。

パラメータ:

obj - 挿入されるコンポーネント

index - 新しいコンポーネントを挿入する位置

例外:

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

addElement

public void addElement(E obj)

指定された要素を Vector の最後に追加し、サイズを 1 増やします。サイズが Vector の容量より大きくなるときは容量が増やされます。

このメソッドは機能的に add(E) メソッド (List インタフェースの一部) と同じです。

パラメータ:

obj - 追加されるコンポーネント

removeElement

public boolean removeElement(Object obj)

最初に検出された (最小インデックスの) 引数の要素を Vector から削除します。オブジェクトが検出されると、そのオブジェクトのインデックスと同じかそれより大きいインデックスの要素はすべて 1 つ前方のインデックスに詰められます。

このメソッドは機能的に remove(Object) メソッド (List インタフェースの一部) と同じです。

パラメータ:

obj - 削除されるコンポーネント

戻り値:

引数がこのベクトルのコンポーネントであった場合は true、そうでない場合は false。

removeAllElements

public void removeAllElements()

Vector からすべての要素を削除し、サイズを 0 に設定します。

このメソッドは機能的に clear() メソッド (List インタフェースの一部) と同じです。

clone

public Object clone()

Vector をコピーします。コピーは内部データ配列の複製への参照を保持するのであって、この Vector オブジェクトの元の内部データ配列への参照を保持するわけではありません。

オーバーライド:

clone、クラス: Object

戻り値:

この Vector の複製

関連項目:

Cloneable

toArray

public Object[] toArray()

Vector 内のすべての要素を正しい順序で保持する配列を返します。

定義:

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

定義:

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

オーバーライド:

toArray、クラス: AbstractCollection<E>

戻り値:

コレクションのすべての要素が格納されている配列

導入されたバージョン:

1.2

関連項目:

Arrays.asList(Object[])

toArray

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

Vector 内のすべての要素が正しい順序で格納されている配列を返します。返される配列の実行時の型は指定された配列の型になります。指定された配列に Vector が収まる場合は、その配列に返されます。それ以外の場合は、指定された配列の実行時の型と Vector のサイズを使って新しい配列が割り当てられます。

Vector が指定された配列に余裕をもって収まる場合、つまり配列が Vector よりも要素を数多く持つ場合、Vector の末尾の直後に来る配列内の要素は null に設定されます。このベクトルに null 要素がないことを呼び出し側が知っている場合にのみ、この特性を利用してベクトルの長さを判断できます。

定義:

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

定義:

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

オーバーライド:

toArray、クラス: AbstractCollection<E>

パラメータ:

a - このベクトルの要素の格納先の配列。配列のサイズが十分でない場合は、同じ実行時の型で新しい配列が格納用として割り当てられる

戻り値:

Vector の要素が格納されている配列

例外:

ArrayStoreException - a の実行時の型が、このベクトル内のすべての要素の実行時の型のスーパータイプでない場合

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

導入されたバージョン:

1.2

get

public E get(int index)

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

定義:

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

定義:

get、クラス: AbstractList<E>

パラメータ:

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

戻り値:

指定されたインデックスにあるオブジェクト

例外:

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

導入されたバージョン:

1.2

set

public E set(int index,
    E element)

Vector 内の指定された位置にある要素を、指定の要素で置き換えます。

定義:

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

オーバーライド:

set、クラス: AbstractList<E>

パラメータ:

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

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

戻り値:

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

例外:

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

導入されたバージョン:

1.2

add

public boolean add(E e)

Vector の末尾に指定の要素を追加します。

定義:

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

定義:

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

オーバーライド:

add、クラス: AbstractList<E>

パラメータ:

e - このベクトルに追加される要素

戻り値:

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

導入されたバージョン:

1.2

remove

public boolean remove(Object o)

Vector 内で最初に検出された指定された要素を削除します。つまり、(o==null ? get(i)==null : o.equals(get(i))) となる、最小のインデックス i を持つ要素を削除します (そのような要素が存在する場合)。

定義:

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

定義:

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

オーバーライド:

remove、クラス: AbstractCollection<E>

パラメータ:

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

戻り値:

指定された要素が Vector 内にあった場合は true

導入されたバージョン:

1.2

add

public void add(int index,
       E element)

Vector 内の指定された位置に指定された要素を挿入します。その位置の現在の要素 (ある場合) とそれ以降の要素を右に移動します (インデックスに 1 を加算)。

定義:

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

オーバーライド:

add、クラス: AbstractList<E>

パラメータ:

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

element - 挿入される要素

例外:

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

導入されたバージョン:

1.2

remove

public E remove(int index)

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

定義:

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

オーバーライド:

remove、クラス: AbstractList<E>

パラメータ:

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

戻り値:

削除された要素

例外:

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

導入されたバージョン:

1.2

clear

public void clear()

すべての要素を Vector から削除します。この呼び出しが返ると、それが例外をスローしないかぎり、Vector は空になります。

定義:

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

定義:

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

オーバーライド:

clear、クラス: AbstractList<E>

導入されたバージョン:

1.2

containsAll

public boolean containsAll(Collection<?> c)

Vector が指定の Collection 内のすべての要素を保持する場合に true を返します。

定義:

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

定義:

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

オーバーライド:

containsAll、クラス: AbstractCollection<E>

パラメータ:

c - 要素がこの Vector に含まれているかどうかを調べるコレクション

戻り値:

Vector が指定されたコレクション内のすべての要素を保持する場合は true

例外:

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

関連項目:

AbstractCollection.contains(Object)

addAll

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

指定された Collection 内のすべての要素をこの Vector の末尾に、その Collection の Iterator によって返される順序で追加します。オペレーションの進行中に指定された Collection が変更された場合の、このオペレーションの動作は定義されていません。これは、その Collection が Vector である場合にこの呼び出しの動作が定義されず、Vector が空でないことを示します。

定義:

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

定義:

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

オーバーライド:

addAll、クラス: AbstractCollection<E>

パラメータ:

c - このベクトルに挿入される要素

戻り値:

このベクトルが呼び出しの結果として変更された場合は true

例外:

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

導入されたバージョン:

1.2

関連項目:

AbstractCollection.add(Object)

removeAll

public boolean removeAll(Collection<?> c)

Vector から、指定された Collection 内に保持されているすべての要素を削除します。

定義:

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

定義:

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

オーバーライド:

removeAll、クラス: AbstractCollection<E>

パラメータ:

c - Vector から削除される要素のコレクション

戻り値:

Vector が呼び出しの結果として変更された場合は true

例外:

ClassCastException - このベクトル内の 1 つ以上の要素の型が、指定されたコレクションと互換でない場合 (省略可能)

NullPointerException - このベクトルに 1 つ以上の null 要素が含まれており、指定されたコレクションが null 要素をサポートしない場合 (省略可能)、または指定されたコレクションが null の場合

導入されたバージョン:

1.2

関連項目:

AbstractCollection.remove(Object), AbstractCollection.contains(Object)

retainAll

public boolean retainAll(Collection<?> c)

指定された Collection 内に保持されている、Vector 内の要素だけを保持します。つまり、Vector から、指定された Collection 内に保持されていないすべての要素を削除します。

定義:

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

定義:

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

オーバーライド:

retainAll、クラス: AbstractCollection<E>

パラメータ:

c - この Vector に保持される要素のコレクション (ほかのすべての要素は削除)

戻り値:

Vector が呼び出しの結果として変更された場合は true

例外:

ClassCastException - このベクトル内の 1 つ以上の要素の型が、指定されたコレクションと互換でない場合 (省略可能)

NullPointerException - このベクトルに 1 つ以上の null 要素が含まれており、指定されたコレクションが null 要素をサポートしない場合 (省略可能)、または指定されたコレクションが null の場合

導入されたバージョン:

1.2

関連項目:

AbstractCollection.remove(Object), AbstractCollection.contains(Object)

addAll

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

指定された Collection 内のすべての要素を、Vector の指定された位置に挿入します。その位置の現在の要素 (ある場合) とそれ以降の要素を右に移動します (インデックスが増えます)。新しい各要素は、指定された Collection のイテレータによって返される順序で Vector 内に表示されます。

定義:

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

オーバーライド:

addAll、クラス: AbstractList<E>

パラメータ:

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

c - このベクトルに挿入される要素

戻り値:

このベクトルが呼び出しの結果として変更された場合は true

例外:

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

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

導入されたバージョン:

1.2

equals

public boolean equals(Object o)

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

定義:

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

定義:

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

オーバーライド:

equals、クラス: AbstractList<E>

パラメータ:

o - この Vector と等しいかどうかを比較する Object

戻り値:

指定された Object が Vector と等しい場合は true

関連項目:

Object.hashCode()、HashMap

hashCode

public int hashCode()

Vector のハッシュコード値を返します。

定義:

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

定義:

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

オーバーライド:

hashCode、クラス: AbstractList<E>

戻り値:

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

関連項目:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

各要素の String 表現を保持している、Vector の文字列表現を返します。

オーバーライド:

toString、クラス: AbstractCollection<E>

戻り値:

このコレクションの文字列表現

subList

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

この List の、fromIndex (これを含む) と toIndex (これを含まない) の間の部分のビューを返します。fromIndex と toIndex が等しい場合は、空の List が返されます。返される List はこの List に連動しているため、返される List 内での変更はこの List に反映され、この List 内での変更は返される List に反映されます。返される List は、この List によってサポートされるすべてのオプションの List オペレーションをサポートします。

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

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

indexOf および lastIndexOf でも、同様のイディオムを作成できます。Collections クラスのアルゴリズムがすべて subList に適用できます。

バッキングリスト (すなわち、この List) が、このメソッドによって返された List を介さずに構造的に変更された場合、返された List のセマンティクスは保証されません。 (構造的な変更とは、List のサイズが変更された場合や、進行中の繰り返しにより不正な結果が生じたなどの理由で List が乱れた場合です。)

定義:

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

オーバーライド:

subList、クラス: AbstractList<E>

パラメータ:

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

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

戻り値:

この List 内の指定された範囲のビュー

例外:

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

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

removeRange

protected void removeRange(int fromIndex,
               int toIndex)

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

オーバーライド:

removeRange、クラス: AbstractList<E>

パラメータ:

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

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

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、インタフェース: Iterable<E>

定義:

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

定義:

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

オーバーライド:

iterator、クラス: AbstractList<E>

戻り値:

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