java.util
クラス Vector

java.lang.Object
  java.util.AbstractCollection
      java.util.AbstractList
          java.util.Vector

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

Serializable, Cloneable, Collection, List, RandomAccess

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

Stack

public class Vector
extends AbstractList
implements List, RandomAccess, Cloneable, Serializable

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

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

Java 2 プラットフォーム Version 1.2 では、このクラスは List を実装するために改良されているため、Java Collections Framework の一部になります。新しいコレクションの実装とは異なり、Vector は同期をとります。

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

通常、非同期の並行変更がある場合、確かな保証を行うことは不可能なので、反復子のフェイルファストの動作を保証することはできません。フェイルファスト反復子は最善努力原則に基づき、ConcurrentModificationException をスローします。したがって、正確を期すためにこの例外に依存するプログラムを書くことは誤りです。反復子のフェイルファストの動作はバグを検出するためにのみ使用するべきです。

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

導入されたバージョン:

JDK1.0

関連項目:

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

フィールドの概要

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

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

modCount

コンストラクタの概要

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

Vector(Collection c)
指定されたコレクションの反復子が返した順序で、その要素を格納する Vector を作成します。

Vector(int initialCapacity)
指定された初期容量、および増加量がゼロである、空の Vector を作成します。

Vector(int initialCapacity, int capacityIncrement)
指定された容量と増加量で空の Vector を作成します。

メソッドの概要

void	add(int index, Object element) Vector 内の指定された位置に指定された要素を挿入します。
boolean	add(Object o) Vector の末尾に指定の要素を追加します。
boolean	addAll(Collection c) 指定された Collection 内のすべての要素をこの Vector の末尾に、その Collection の Iterator によって返される順序で追加します。
boolean	addAll(int index, Collection c) 指定された Collection 内のすべての要素を、Vector の指定された位置に挿入します。
void	addElement(Object obj) 指定された要素を Vector の最後に追加し、サイズを 1 増やします。
int	capacity() Vector の現在の容量を返します。
void	clear() すべての要素を Vector から削除します。
Object	clone() Vector をコピーします。
boolean	contains(Object elem) 指定されたオブジェクトが Vector の要素であるかどうかを判定します。
boolean	containsAll(Collection c) Vector が指定の Collection 内のすべての要素を保持する場合に true を返します。
void	copyInto(Object[] anArray) Vector の要素を、指定された配列にコピーします。
Object	elementAt(int index) 指定されたインデックスの要素を返します。
Enumeration	elements() この Vector の要素を列挙したリストを返します。
void	ensureCapacity(int minCapacity) Vector の収容量を必要に応じて増やして、少なくとも最小収容量の引数で指定される要素数を保持できることを保証します。
boolean	equals(Object o) 指定された Object が Vector と等しいかどうかを比較します。
Object	firstElement() Vector の最初の要素 (インデックス 0 の項目) を返します。
Object	get(int index) Vector 内の指定された位置にある要素を返します。
int	hashCode() Vector のハッシュコード値を返します。
int	indexOf(Object elem) equals メソッドを使って等しいかどうかを判定しながら、指定された引数と同じ内容の要素を先頭から検索します。
int	indexOf(Object elem, int index) equals メソッドを使って等しいかどうかを判定しながら、指定された引数と同じ内容の要素を指定された index から検索します。
void	insertElementAt(Object obj, int index) 指定されたオブジェクトを、ベクトルの指定された index のコンポーネントとして挿入します。
boolean	isEmpty() Vector が要素を持たないかどうかを判定します。
Object	lastElement() Vector の最後の要素を返します。
int	lastIndexOf(Object elem) Vector を末尾から検索して、指定されたオブジェクトと同じ内容の要素のインデックスを返します。
int	lastIndexOf(Object elem, int index) 指定されたインデックスから後ろ向きに指定のオブジェクトを検索し、検出されたインデックスを返します。
Object	remove(int index) この Vector 内の指定された位置から要素を削除し、後続の要素を左側に移動して、それぞれのインデックスから 1 を減算します。
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 (これを含まない) の範囲のインデックスを持つすべての要素をこの List から削除します。
boolean	retainAll(Collection c) 指定された Collection 内に保持されている、Vector 内の要素だけを保持します。
Object	set(int index, Object element) Vector 内の指定された位置にある要素を、指定の要素で置き換えます。
void	setElementAt(Object obj, int index) このベクトルの指定された index のコンポーネントを、指定されたオブジェクトとして設定します。
void	setSize(int newSize) Vector のサイズを設定します。
int	size() Vector の要素数を返します。
List	subList(int fromIndex, int toIndex) この List の、fromIndex (これを含む) と toIndex (これを含まない) の間の部分のビューを返します。
Object[]	toArray() Vector 内のすべての要素を正しい順序で保持する配列を返します。
Object[]	toArray(Object[] a) Vector 内のすべての要素が正しい順序で格納されている配列を返します。
String	toString() 各要素の String 表現を保持している、Vector の文字列表現を返します。
void	trimToSize() Vector の容量を、現在の容量にまで減らします。

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

iterator, listIterator, listIterator

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

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

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

iterator, listIterator, listIterator

フィールドの詳細

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)

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

パラメータ:

initialCapacity - Vector の初期容量

capacityIncrement - Vector がオーバーフローしたときに追加される容量

例外:

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

Vector

public Vector(int initialCapacity)

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

パラメータ:

initialCapacity - Vector の初期容量

例外:

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

Vector

public Vector()

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

Vector

public Vector(Collection c)

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

パラメータ:

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

例外:

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

導入されたバージョン:

1.2

メソッドの詳細

copyInto

public void copyInto(Object[] anArray)

Vector の要素を、指定された配列にコピーします。このベクトル内のインデックス k の項目が、anArray の要素 k にコピーされます。配列には、このベクトルのすべてのオブジェクトを保持する大きさが必要です。十分な大きさがない場合は、IndexOutOfBoundsException がスローされます。

パラメータ:

anArray - コピーした要素を格納する配列

例外:

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

trimToSize

public void trimToSize()

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

ensureCapacity

public void ensureCapacity(int minCapacity)

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

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

パラメータ:

minCapacity - 保証したい最小容量

setSize

public void setSize(int newSize)

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

パラメータ:

newSize - Vector の新しいサイズ

例外:

ArrayIndexOutOfBoundsException - サイズが負の値の場合

capacity

public int capacity()

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

戻り値:

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

size

public int size()

Vector の要素数を返します。

定義:

インタフェース Collection 内の size

定義:

インタフェース List 内の size

定義:

クラス AbstractCollection 内の size

戻り値:

Vector の要素数

isEmpty

public boolean isEmpty()

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

定義:

インタフェース Collection 内の isEmpty

定義:

インタフェース List 内の isEmpty

オーバーライド:

クラス AbstractCollection 内の isEmpty

戻り値:

Vector が要素を持っていない、つまりそのサイズが 0 の場合にだけ true、そうでない場合は false

elements

public Enumeration elements()

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

戻り値:

Vector の要素のリスト

関連項目:

Enumeration, Iterator

contains

public boolean contains(Object elem)

指定されたオブジェクトが Vector の要素であるかどうかを判定します。

定義:

インタフェース Collection 内の contains

定義:

インタフェース List 内の contains

オーバーライド:

クラス AbstractCollection 内の contains

パラメータ:

elem - オブジェクト

戻り値:

指定されたオブジェクトが equals メソッドによって Vector 内の要素と同じと確認された場合にだけ true、そうでない場合は false

indexOf

public int indexOf(Object elem)

equals メソッドを使って等しいかどうかを判定しながら、指定された引数と同じ内容の要素を先頭から検索します。

定義:

インタフェース List 内の indexOf

オーバーライド:

クラス AbstractList 内の indexOf

パラメータ:

elem - オブジェクト

戻り値:

Vector 内で最初の引数のインデックス、つまり elem.equals(elementData[k]) が true であるような最小値 k。オブジェクトが見つからない場合は -1 が返される

関連項目:

Object.equals(Object)

indexOf

public int indexOf(Object elem,
                   int index)

equals メソッドを使って等しいかどうかを判定しながら、指定された引数と同じ内容の要素を指定された index から検索します。

パラメータ:

elem - オブジェクト

index - 検索を開始する位置の負以外のインデックス

戻り値:

Vector 内で位置 index かそれ以降の最初のオブジェクト引数のインデックス、つまり elem.equals(elementData[k]) && (k >= index) が true であるような最小値 k。オブジェクトが見つからない場合は -1 が返される。index >= この Vector の現在サイズの場合は -1 が返される

例外:

IndexOutOfBoundsException - index が負の値の場合

関連項目:

Object.equals(Object)

lastIndexOf

public int lastIndexOf(Object elem)

Vector を末尾から検索して、指定されたオブジェクトと同じ内容の要素のインデックスを返します。

定義:

インタフェース List 内の lastIndexOf

オーバーライド:

クラス AbstractList 内の lastIndexOf

パラメータ:

elem - 設定する要素

戻り値:

Vector 内で最後に検出された指定のオブジェクトのインデックス、つまり elem.equals(elementData[k]) が true であるような最大値 k。オブジェクトが見つからない場合は -1 が返される

lastIndexOf

public int lastIndexOf(Object elem,
                       int index)

指定されたインデックスから後ろ向きに指定のオブジェクトを検索し、検出されたインデックスを返します。

パラメータ:

elem - 設定する要素

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

戻り値:

Vector 内で位置 index の前でもっとも近くにある指定のオブジェクトのインデックス、つまり elem.equals(elementData[k]) && (k <= index) が true であるような最大値 k。オブジェクトが見つからない場合は -1。index が負の値である場合は -1

例外:

IndexOutOfBoundsException - index が Vector の現在のサイズよりも大きいか等しい場合

elementAt

public Object elementAt(int index)

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

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

パラメータ:

index - Vector のインデックス

戻り値:

指定されたインデックスの要素

例外:

ArrayIndexOutOfBoundsException - index が負の場合、または Vector オブジェクトの現在のサイズよりも小さくない場合

関連項目:

get(int), List

firstElement

public Object firstElement()

Vector の最初の要素 (インデックス 0 の項目) を返します。

戻り値:

Vector の最初の要素

例外:

NoSuchElementException - Vector が要素を持たない場合

lastElement

public Object lastElement()

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

戻り値:

Vector の最後の要素、すなわちインデックス size() - 1 の要素

例外:

NoSuchElementException - Vector が空の場合

setElementAt

public void setElementAt(Object obj,
                         int index)

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

インデックスは、0 に等しいか、それより大きい値でなければなりません。また、Vector の現在のサイズより小さい値でなければなりません。

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

パラメータ:

obj - 要素に設定されるオブジェクト

index - インデックス

例外:

ArrayIndexOutOfBoundsException - インデックスが不正だった場合

関連項目:

size(), List, set(int, java.lang.Object)

removeElementAt

public void removeElementAt(int index)

指定されたインデックスのコンポーネントを削除します。指定された index に等しいか、それより大きいインデックスの要素は、すべて 1 つ前方のインデックスに詰められます。Vector のサイズは 1 だけ減ります。

インデックスは、0 に等しいか、それより大きい値でなければなりません。また、Vector の現在のサイズより小さい値でなければなりません。

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

パラメータ:

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

例外:

ArrayIndexOutOfBoundsException - インデックスが不正だった場合

関連項目:

size(), remove(int), List

insertElementAt

public void insertElementAt(Object obj,
                            int index)

指定されたオブジェクトを、ベクトルの指定された index のコンポーネントとして挿入します。指定された index に等しいか、それより大きいインデックスの要素は、すべて 1 つ後方のインデックスに詰められます。

インデックスは、0 に等しいか、それより大きい値でなければなりません。また、 Vector の現在のサイズ以下の値にする必要があります。インデックスが Vector の現在のサイズに等しい場合、新しい要素は Vector の末尾に追加されます。

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

パラメータ:

obj - 挿入される要素

index - 新しい要素を挿入する位置

例外:

ArrayIndexOutOfBoundsException - インデックスが不正だった場合

関連項目:

size(), add(int, Object), List

addElement

public void addElement(Object obj)

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

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

パラメータ:

obj - 追加される要素

関連項目:

add(Object), List

removeElement

public boolean removeElement(Object obj)

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

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

パラメータ:

obj - 削除される要素

戻り値:

引数が Vector の要素である場合は true、そうでない場合は false

関連項目:

List.remove(Object), List

removeAllElements

public void removeAllElements()

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

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

関連項目:

clear(), List

clone

public Object clone()

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

オーバーライド:

クラス Object 内の clone

戻り値:

この Vector の複製

関連項目:

Cloneable

toArray

public Object[] toArray()

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

定義:

インタフェース Collection 内の toArray

定義:

インタフェース List 内の toArray

オーバーライド:

クラス AbstractCollection 内の toArray

戻り値:

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

導入されたバージョン:

1.2

関連項目:

Arrays.asList(Object[])

toArray

public Object[] toArray(Object[] a)

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

Vector が指定された配列に余裕をもって収まる場合、つまり配列が Vector よりも要素を数多く持つ場合、Vector の末尾の直後に来る配列内の要素は null に設定されます。これは、Vector がまったく null 要素を保持していないことを呼び出し側が認識している場合にだけ、Vector の長さを確認する際に役に立ちます。

定義:

インタフェース Collection 内の toArray

定義:

インタフェース List 内の toArray

オーバーライド:

クラス AbstractCollection 内の toArray

パラメータ:

a - 配列が十分な大きさを持つ場合は、Vector の要素が格納される配列。そうでない場合は、要素を格納するために同じ実行時の型の新しい配列が割り当てられる

戻り値:

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

例外:

ArrayStoreException - a の実行時の型が、Vector 内の各要素の実行時の型のスーパータイプでない場合

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

導入されたバージョン:

1.2

get

public Object get(int index)

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

定義:

インタフェース List 内の get

定義:

クラス AbstractList 内の get

パラメータ:

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

戻り値:

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

例外:

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

導入されたバージョン:

1.2

set

public Object set(int index,
                  Object element)

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

定義:

インタフェース List 内の set

オーバーライド:

クラス AbstractList 内の set

パラメータ:

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

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

戻り値:

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

例外:

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

導入されたバージョン:

1.2

add

public boolean add(Object o)

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

定義:

インタフェース Collection 内の add

定義:

インタフェース List 内の add

オーバーライド:

クラス AbstractList 内の add

パラメータ:

o - Vector に追加される要素

戻り値:

true (Collection.add の汎用規約どおり)

導入されたバージョン:

1.2

remove

public boolean remove(Object o)

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

定義:

インタフェース Collection 内の remove

定義:

インタフェース List 内の remove

オーバーライド:

クラス AbstractCollection 内の remove

パラメータ:

o - Vector から削除される要素 (その要素がある場合)

戻り値:

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

導入されたバージョン:

1.2

add

public void add(int index,
                Object element)

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

定義:

インタフェース List 内の add

オーバーライド:

クラス AbstractList 内の add

パラメータ:

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

element - 挿入される要素

例外:

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

導入されたバージョン:

1.2

remove

public Object remove(int index)

この Vector 内の指定された位置から要素を削除し、後続の要素を左側に移動して、それぞれのインデックスから 1 を減算します。Vector から削除された要素を返します。

定義:

インタフェース List 内の remove

オーバーライド:

クラス AbstractList 内の remove

パラメータ:

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

戻り値:

削除された要素

例外:

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

導入されたバージョン:

1.2

clear

public void clear()

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

定義:

インタフェース Collection 内の clear

定義:

インタフェース List 内の clear

オーバーライド:

クラス AbstractList 内の clear

導入されたバージョン:

1.2

containsAll

public boolean containsAll(Collection c)

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

定義:

インタフェース Collection 内の containsAll

定義:

インタフェース List 内の containsAll

オーバーライド:

クラス AbstractCollection 内の containsAll

パラメータ:

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

戻り値:

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

例外:

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

関連項目:

AbstractCollection.contains(Object)

addAll

public boolean addAll(Collection c)

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

定義:

インタフェース Collection 内の addAll

定義:

インタフェース List 内の addAll

オーバーライド:

クラス AbstractCollection 内の addAll

パラメータ:

c - Vector に挿入される要素

戻り値:

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

例外:

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

導入されたバージョン:

1.2

関連項目:

AbstractCollection.add(Object)

removeAll

public boolean removeAll(Collection c)

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

定義:

インタフェース Collection 内の removeAll

定義:

インタフェース List 内の removeAll

オーバーライド:

クラス AbstractCollection 内の removeAll

パラメータ:

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

戻り値:

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

例外:

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

導入されたバージョン:

1.2

関連項目:

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

retainAll

public boolean retainAll(Collection c)

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

定義:

インタフェース Collection 内の retainAll

定義:

インタフェース List 内の retainAll

オーバーライド:

クラス AbstractCollection 内の retainAll

パラメータ:

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

戻り値:

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

例外:

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

導入されたバージョン:

1.2

関連項目:

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

addAll

public boolean addAll(int index,
                      Collection c)

指定された Collection 内のすべての要素を、Vector の指定された位置に挿入します。その位置とそれ以降に要素がある場合は、それらを右に移動して、各要素のインデックスに 1 を加えます。新しい各要素は、指定された Collection の反復子によって返される順序で Vector 内に表示されます。

定義:

インタフェース List 内の addAll

オーバーライド:

クラス AbstractList 内の addAll

パラメータ:

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

c - Vector に挿入される要素

戻り値:

Vector が呼び出しの結果として変更された場合は 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 を返します。2 つの要素 e1 と e2 は、(e1==null ? e2==null :e1.equals(e2)) の場合に「等しい」と言うことができます。つまり、同じ順序で同じ要素を保持している場合に、2 つの List は等しいものと判定されます。

定義:

インタフェース Collection 内の equals

定義:

インタフェース List 内の equals

オーバーライド:

クラス AbstractList 内の equals

パラメータ:

o - Vector と同じかどうかを比較される Object

戻り値:

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

関連項目:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

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

定義:

インタフェース Collection 内の hashCode

定義:

インタフェース List 内の hashCode

オーバーライド:

クラス AbstractList 内の hashCode

戻り値:

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

関連項目:

Object.equals(java.lang.Object), Hashtable

toString

public String toString()

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

オーバーライド:

クラス AbstractCollection 内の toString

戻り値:

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

subList

public List 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 が乱れた場合です。

定義:

インタフェース List 内の subList

オーバーライド:

クラス AbstractList 内の subList

パラメータ:

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

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

戻り値:

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

例外:

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

IllegalArgumentException - 端点のインデックス値が不正な場合 (fromIndex > toIndex)

removeRange

protected void removeRange(int fromIndex,
                           int toIndex)

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

オーバーライド:

クラス AbstractList 内の removeRange

パラメータ:

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

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