java.util
クラス Vector

java.lang.Object
  |
  +--java.util.Vector
直接の既知のサブクラス:
Stack

public class Vector
extends Object

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

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

導入されたバージョン:
JDK1.0

フィールドの概要
protected  int capacityIncrement
          Vector のサイズがその容量を超えるときに自動的に増やされる量です。
protected  int elementCount
          Vector 内の有効な要素数です。
protected  Object[] elementData
          Vector の要素が格納される配列バッファです。
 
コンストラクタの概要
Vector()
          空の Vector を作成します。
Vector(int initialCapacity)
          指定された初期容量で空の Vector を作成します。
Vector(int initialCapacity, int capacityIncrement)
          指定された容量と増加量で空の Vector を作成します。
 
メソッドの概要
 void addElement(Object obj)
          指定の要素を Vector の最後に追加し、サイズを 1 増やします。
 int capacity()
          Vector の現在の容量を返します。
 boolean contains(Object elem)
          指定されたオブジェクトが Vector の要素であるかどうかを判定します。
 void copyInto(Object[] anArray)
          この Vector の要素を、指定された配列にコピーします。
 Object elementAt(int index)
          指定されたインデックスの要素を返します。
 Enumeration elements()
          この Vector の要素を列挙したリストを返します。
 void ensureCapacity(int minCapacity)
          Vector の収容量を必要に応じて増やして、少なくとも最小収容量の引数で指定される要素数を保持できることを保証します。
 Object firstElement()
          Vector の最初の要素を返します。
 int indexOf(Object elem)
          equals メソッドを使って等しいかどうかを判定しながら、指定された引数と同じ内容の要素を先頭から検索します。
 int indexOf(Object elem, int index)
          equals メソッドを使って等しいかどうかを判定しながら、指定された引数と同じ内容の要素を指定された index から検索します。
 void insertElementAt(Object obj, int index)
          Vector の指定されたインデックスに、指定されたオブジェクトを要素として挿入します。
 boolean isEmpty()
          Vector が要素を持たないかどうかを判定します。
 Object lastElement()
          Vector の最後の要素を返します。
 int lastIndexOf(Object elem)
          Vector を末尾から検索して、指定されたオブジェクトと同じ内容の要素のインデックスを返します。
 int lastIndexOf(Object elem, int index)
          指定されたインデックスから後ろ向きに指定のオブジェクトを検索し、検出されたインデックスを返します。
 void removeAllElements()
          Vector からすべての要素を削除し、サイズを 0 に設定します。
 boolean removeElement(Object obj)
          最初に検出された引数の要素をこの Vector から削除します。
 void removeElementAt(int index)
          指定されたインデックスの要素を削除します。
 void setElementAt(Object obj, int index)
          Vector の指定された index の要素に、指定されたオブジェクトを設定します。
 void setSize(int newSize)
          Vector のサイズを設定します。
 int size()
          Vector の要素数を返します。
 String toString()
          この Vector の文字列表現を返します。
 void trimToSize()
          この Vector の容量を、現在の Vector のサイズに縮小します。
 
クラス java.lang.Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

elementData

protected Object[] elementData
Vector の要素が格納される配列バッファです。Vector の容量はこの配列バッファの長さになります。
導入されたバージョン:
JDK1.0

elementCount

protected int elementCount
Vector 内の有効な要素数です。
導入されたバージョン:
JDK1.0

capacityIncrement

protected int capacityIncrement
Vector のサイズがその容量を超えるときに自動的に増やされる量です。容量の増加量が 0 の場合、拡大の必要があるたびに Vector の容量は倍になります。
導入されたバージョン:
JDK1.0
コンストラクタの詳細

Vector

public Vector(int initialCapacity,
              int capacityIncrement)
指定された容量と増加量で空の Vector を作成します。
パラメータ:
initialCapacity - Vector の初期容量
capacityIncrement - Vector があふれたときに増加される容量
例外:
IllegalArgumentException - 指定された初期容量が負の場合

Vector

public Vector(int initialCapacity)
指定された初期容量で空の Vector を作成します。
パラメータ:
initialCapacity - Vector の初期容量
導入されたバージョン:
JDK1.0

Vector

public Vector()
空の Vector を作成します。
導入されたバージョン:
JDK1.0
メソッドの詳細

copyInto

public void copyInto(Object[] anArray)
この Vector の要素を、指定された配列にコピーします。配列は、この Vector 内のすべてのオブジェクトを格納するのに十分な大きさでなければなりません。
パラメータ:
anArray - コピーした要素を格納する配列
導入されたバージョン:
JDK1.0

trimToSize

public void trimToSize()
この Vector の容量を、現在の Vector のサイズに縮小します。このオペレーションをアプリケーションで利用すると、Vector のメモリ使用量を最小にできます。
導入されたバージョン:
JDK1.0

ensureCapacity

public void ensureCapacity(int minCapacity)
Vector の収容量を必要に応じて増やして、少なくとも最小収容量の引数で指定される要素数を保持できることを保証します。
パラメータ:
minCapacity - 保証したい最小容量
導入されたバージョン:
JDK1.0

setSize

public void setSize(int newSize)
Vector のサイズを設定します。新しいサイズが現在のサイズより大きい場合は、新しい null 要素が Vector の最後に追加されます。現在のサイズよりも小さい場合は、インデックス newSize とそれ以降の要素はすべて破棄されます。
パラメータ:
newSize - Vector の新しいサイズ
導入されたバージョン:
JDK1.0

capacity

public int capacity()
Vector の現在の容量を返します。
戻り値:
この Vector の現在の容量
導入されたバージョン:
JDK1.0

size

public int size()
Vector の要素数を返します。
戻り値:
Vector の要素数
導入されたバージョン:
JDK1.0

isEmpty

public boolean isEmpty()
Vector が要素を持たないかどうかを判定します。
戻り値:
この Vector に要素がない場合は true、そうでない場合は false
導入されたバージョン:
JDK1.0

elements

public Enumeration elements()
この Vector の要素を列挙したリストを返します。
戻り値:
Vector の要素のリスト
導入されたバージョン:
JDK1.0
関連項目:
Enumeration

contains

public boolean contains(Object elem)
指定されたオブジェクトが Vector の要素であるかどうかを判定します。
パラメータ:
elem - オブジェクト
戻り値:
指定されたオブジェクトがこの Vector 内の要素である場合は true、そうでない場合は false
導入されたバージョン:
JDK1.0

indexOf

public int indexOf(Object elem)
equals メソッドを使って等しいかどうかを判定しながら、指定された引数と同じ内容の要素を先頭から検索します。
パラメータ:
elem - オブジェクト
戻り値:
この Vector 内の検索で最初に一致した引数のインデックス。オブジェクトが見つからない場合は -1
導入されたバージョン:
JDK1.0
関連項目:
Object.equals(java.lang.Object)

indexOf

public int indexOf(Object elem,
                   int index)
equals メソッドを使って等しいかどうかを判定しながら、指定された引数と同じ内容の要素を指定された index から検索します。
パラメータ:
elem - オブジェクト
index - 検索を開始する位置のインデックス
戻り値:
この Vector 内の位置 index 以降の検索で最初に一致したオブジェクト引数のインデックス。オブジェクトが見つからない場合は -1
導入されたバージョン:
JDK1.0
関連項目:
Object.equals(java.lang.Object)

lastIndexOf

public int lastIndexOf(Object elem)
Vector を末尾から検索して、指定されたオブジェクトと同じ内容の要素のインデックスを返します。
パラメータ:
elem - 設定する要素
戻り値:
この Vector 内で指定のオブジェクトと一致する最後のオブジェクトのインデックス。オブジェクトが見つからない場合は -1
導入されたバージョン:
JDK1.0

lastIndexOf

public int lastIndexOf(Object elem,
                       int index)
指定されたインデックスから後ろ向きに指定のオブジェクトを検索し、検出されたインデックスを返します。
パラメータ:
elem - 設定する要素
index - 検索を開始する位置のインデックス
戻り値:
この Vector 内の index より前の位置で指定のオブジェクトと一致する最後のオブジェクトのインデックス。オブジェクトが見つからない場合は -1
導入されたバージョン:
JDK1.0

elementAt

public Object elementAt(int index)
指定されたインデックスの要素を返します。
パラメータ:
index - Vector のインデックス
戻り値:
指定されたインデックスの要素
例外:
ArrayIndexOutOfBoundsException - 無効なインデックスを指定した場合
導入されたバージョン:
JDK1.0

firstElement

public Object firstElement()
Vector の最初の要素を返します。
戻り値:
Vector の最初の要素
例外:
NoSuchElementException - Vector が要素を持たない場合
導入されたバージョン:
JDK1.0

lastElement

public Object lastElement()
Vector の最後の要素を返します。
戻り値:
Vector の最後の要素、すなわちインデックス size() - 1 の要素
例外:
NoSuchElementException - Vector が空の場合
導入されたバージョン:
JDK1.0

setElementAt

public void setElementAt(Object obj,
                         int index)
Vector の指定された index の要素に、指定されたオブジェクトを設定します。そのインデックスにあった要素は破棄されます。

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

パラメータ:
obj - 要素に設定されるオブジェクト
index - インデックス
例外:
ArrayIndexOutOfBoundsException - インデックスが不正だった場合
導入されたバージョン:
JDK1.0
関連項目:
size()

removeElementAt

public void removeElementAt(int index)
指定されたインデックスの要素を削除します。この Vector 内にある各要素のうち、指定された index と等しいか、それより大きいインデックスを持つすべての要素は前方に移動し、そのインデックスの値は以前より 1 つ小さい値になります。

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

パラメータ:
index - 削除されるオブジェクトのインデックス
例外:
ArrayIndexOutOfBoundsException - インデックスが不正だった場合
導入されたバージョン:
JDK1.0
関連項目:
size()

insertElementAt

public void insertElementAt(Object obj,
                            int index)
Vector の指定されたインデックスに、指定されたオブジェクトを要素として挿入します。指定された index に等しいか、それより大きいインデックスの要素はすべて 1 つ後方のインデックスにずれます。

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

パラメータ:
obj - 挿入される要素
index - 新しい要素を挿入する位置
例外:
ArrayIndexOutOfBoundsException - インデックスが不正だった場合
導入されたバージョン:
JDK1.0
関連項目:
size()

addElement

public void addElement(Object obj)
指定の要素を Vector の最後に追加し、サイズを 1 増やします。サイズが Vector の容量より大きくなるときは容量が増やされます。
パラメータ:
obj - 追加される要素
導入されたバージョン:
JDK1.0

removeElement

public boolean removeElement(Object obj)
最初に検出された引数の要素をこの Vector から削除します。この Vector でオブジェクトが検出されると、この Vector 内にある各要素のうち、そのオブジェクトのインデックスと等しいかそれより大きいインデックスを持つ要素はすべて前方に移動し、そのインデックスの値は以前より 1 つ小さい値になります。
パラメータ:
obj - 削除される要素
戻り値:
引数が Vector の要素である場合は true、そうでない場合は false
導入されたバージョン:
JDK1.0

removeAllElements

public void removeAllElements()
Vector からすべての要素を削除し、サイズを 0 に設定します。
導入されたバージョン:
JDK1.0

toString

public String toString()
この Vector の文字列表現を返します。
オーバーライド:
クラス Object 内の toString
戻り値:
この Vector の文字列表現
導入されたバージョン:
JDK1.0