Vector
类实现了可动态扩充的对象数组。类似数组,它包含的元素可通过数组下标来访问。但是,在 Vector
创建之后。Vector
可根据增加和删除元素的需要来扩大或缩小。
每个向量可通过维护 capacity
和
capacityIncrement
来优化存储空间的管理。capacity
至少和向量大小一样大;但它通常会更大些,因为向量会添加组件,向量的存储空间会根据 capacityIncrement
增加。
应用在插入大数量的组件之前会增加向量的容量;这减少了再分配的数量。
类 java.util.Vector
java.lang.Object
|
+----java.util.Vector
- public class Vector
- extends Object
- implements Cloneable, Serializable
- 下列类的父类:
- Stack
变量索引
- capacityIncrement
- 当向量的大小超过它的容量时的向量容量的自动增加量。
- elementCount
- 向量中的有效元素数。
- elementData
- 存储向量中元素的数组缓冲区。
构造子索引
- Vector()
- 构造一个空向量。
- Vector(int)
- 用指定的初始化容量构造一个空向量。
- Vector(int, int)
- 用指定的初始化容量和容量增量构造一个空向量。
方法索引
- addElement(Object)
- 在向量尾部添加一个指定组件,并把它的长度加一。
- capacity()
- 返回当前向量的容量。
- clone()
- 返回该向量的一个 clone 。
- contains(Object)
- 测试指定对象是否该向量的一个元素。
- copyInto(Object[])
- 把该向量的元素复制到指定数组中。
- elementAt(int)
- 返回指定下标处的组件。
- elements()
- 返回该向量的元素的一个枚举。
- ensureCapacity(int)
- 增加向量容量,必要的话,保证它至少能容纳由最小容量参数指定的组件数。
- firstElement()
- 返回该向量的第一个元素。
- indexOf(Object)
- 查找给定参数在向量中第一次出现的位置,并用
equals
方法测试它们是否相等。
- indexOf(Object, int)
- 从
index
处开始查找给定参数在向量中第一次出现的位置,并用 equals
方法测试它们是否相等。
- insertElementAt(Object, int)
- 在指定的
index
处插入作为该向量元素的指定对象。 - isEmpty()
- 测试该向量是否无元素。
- lastElement()
- 返回向量的最后一个元素。
- lastIndexOf(Object)
- 返回向量中最后出现的指定对象的下标。
- lastIndexOf(Object, int)
- 从指定的下标向后查找指定的对象,并返回它的下标。
- removeAllElements()
- 删除向量的所有元素并把它的大小置为零。
- removeElement(Object)
- 从向量中删除第一个出现的参数。
- removeElementAt(int)
- 删除指定下标处的元素。
- setElementAt(Object, int)
- 设置在向量中指定的
index
处的元素为指定的对象。
- setSize(int)
- 设置向量的大小。
- size()
- 返回该向量的元素数。
- toString()
- 返回该向量的字符串表示。
- trimToSize()
- 把该向量的容量调整为向量的当前大小。
变量
elementData
protected Object elementData[]
- 存储向量中的元素的数组缓冲区。向量的容量就是该数组缓冲区的长度。
elementCount
protected int elementCount
- 向量中的有效元素数。
capacityIncrement
protected int capacityIncrement
- 当向量大小超过它的容量时的向量容量的自动增加量。如果容量增量为
0
, 向量的容量在每次需要增加时会扩充一倍。
构造子
Vector
public Vector(int initialCapacity,
int capacityIncrement)
- 用指定的初始化容量和容量增量构造一个空向量。
- 参数:
- initialCapacity - 向量的初始容量。
- capacityIncrement - 当向量溢出时容量的增长量。
Vector
public Vector(int initialCapacity)
- 用指定的初始化容量构造一个空向量。
- 参数:
- initialCapacity - 向量的初始容量。
Vector
public Vector()
- 构造一个空向量。
方法
copyInto
public final synchronized void copyInto(Object anArray[])
- 把该向量的元素复制到指定数组中。
数组必须足够大到可容纳向量中的所有对象。
- 参数:
- anArray - 放复制元素的数组。
trimToSize
public final synchronized void trimToSize()
- 把该向量的容量调整为向量的当前大小。应用可使用该操作最小化向量存储空间。
ensureCapacity
public final synchronized void ensureCapacity(int minCapacity)
- 增加向量容量,必要的话,保证它至少能容纳由最小容量参数指定的组件数。
- 参数:
- minCapacity - 要求的最小容量。
setSize
public final synchronized void setSize(int newSize)
- 设置向量的大小。 如果新大小大于当前大小,则新的
null
项添加到向量尾部。如果新的大小小于当前大小,所有下标大于或等于 newSize
的元素将被抛弃。
- 参数:
- newSize - 向量的新大小。
capacity
public final int capacity()
- 返回该向量的当前容量。
- 返回值:
- 该向量的当前容量。
size
public final int size()
- 返回该向量的元素数。
- 返回值:
- 该向量的元素数。
isEmpty
public final boolean isEmpty()
- 测试该向量是否无元素。
- 返回值:
- 如果该向量无元素,返回
true
;反之返回
false
。
elements
public final synchronized Enumeration elements()
- 返回该向量的元素的一个枚举。
- 返回值:
- 该向量的元素的一个枚举。
- 参见:
- Enumeration
contains
public final boolean contains(Object elem)
- 测试指定对象是该向量的一个元素。
- 参数:
- elem - 一个对象。
- 返回值:
- 如果指定对象是该向量中的一个元素,则返回
true
;否则返回 false
。
indexOf
public final int indexOf(Object elem)
- 查找给定参数在向量中第一次出现的位置,并用
equals
方法测试它们是否相等。
- 参数:
- elem - 一个对象。
- 返回值:
- 参数在向量中第一次出现处的下标;如果该对象未找到,则返回
-1
。
- 参见:
- equals
indexOf
public final synchronized int indexOf(Object elem,
int index)
- 从
index
处开始查找给定参数在向量中第一次出现的位置,并用 equals
方法测试它们是否相等。
- 参数:
- elem - 一个对象。
- index - 开始查找的位置的下标。
- 返回值:
- 参数在向量中的
index
处或在它之后第一次出现的位置的下标;如果该对象未找到,则返回 -1
。
- 参见:
- equals
lastIndexOf
public final int lastIndexOf(Object elem)
- 返回向量中最后出现的指定对象的下标。
- 参数:
- elem - 指定的元素。
- 返回值:
- 指定对象在向量中最后一次出现处的下标;如果该对象未找到,则返回
-1
。
lastIndexOf
public final synchronized int lastIndexOf(Object elem,
int index)
- 从指定的下标向后查找指定的对象,并返回它的下标。
- 参数:
- elem - 指定的元素。
- index - 开始查找的位置的下标。
- 返回值:
- 指定对象在向量中的
index
处或在它之后第一次出现的位置的下标;如果该对象未找到,则返回 -1
。
elementAt
public final synchronized Object elementAt(int index)
- 返回指定下标处的组件。
- 参数:
- index - 向量中的一个下标。
- 返回值:
- 指定下标处的元素。
- 抛出:
ArrayIndexOutOfBoundsException
- 如果给出无效的下标。
firstElement
public final synchronized Object firstElement()
- 返回该向量的第一个元素。
- 返回值:
- 该向量的第一个元素。
- 抛出:
NoSuchElementException
- 如果该向量没有元素。
lastElement
public final synchronized Object lastElement()
- 返回向量的最后一个元素。
- 返回值:
- 向量的最后一个元素,即在下标
size() - 1
处的元素。
- 抛出:
NoSuchElementException
- 如果该向量为空。
setElementAt
public final synchronized void setElementAt(Object obj,
int index)
- 设置在向量中指定的
index
处的元素为指定的对象。
在该位置的先前元素被抛弃。
下标值必须大于或等于0
,并且小于向量的当前大小。
- 参数:
- obj - 元素被设置成的那个对象。
- index - 指定下标。
- 抛出:
ArrayIndexOutOfBoundsException
- 如果下标无效。
- 参见:
- size
removeElementAt
public final synchronized void removeElementAt(int index)
- 删除指定下标处的元素。 在该向量中下标大于或等于
index
的元素的下标值减一。
下标值必须大于或等于0
,并且小于向量的当前大小。
- 参数:
- index - 要删除对象的下标。
- 抛出:
ArrayIndexOutOfBoundsException
- 如果下标无效。
- 参见:
- size
insertElementAt
public final synchronized void insertElementAt(Object obj,
int index)
- 在指定的
index
处插入作为该向量元素的指定对象。
在该向量中下标大于或等于 index
的元素的下标值加一。
下标值必须大于或等于0
,并且小于或等于向量的当前大小。
- 参数:
- obj - 要插入的元素
- index - 插入新元素的位置。
- 抛出:
ArrayIndexOutOfBoundsException
- 如果下标无效。
- 参见:
- size
addElement
public final synchronized void addElement(Object obj)
- 在向量尾部添加一个指定组件,并把它的长度加一。 当向量大小超过它的容量时向量的容量自动增加。
- 参数:
- obj - 要添加的元素。
removeElement
public final synchronized boolean removeElement(Object obj)
- 从向量中删除第一个出现的参数。 如果在向量中找到该对象,在该向量中下标大于或等于
index
的每个元素的下标值减一。
- 参数:
- obj - 要删除的元素。
- 返回值:
- 如果参数是向量的一个元素,返回
true
;否则返回
false
。
removeAllElements
public final synchronized void removeAllElements()
- 删除向量的所有元素并把它的大小置为零。
clone
public synchronized Object clone()
- 返回该向量的一个副本 。
- 返回值:
- 该向量的一个副本。
- 覆盖:
- 类 Object 中的 clone
toString
public final synchronized String toString()
- 返回该向量的字符串表示。
- 返回值:
- 该向量的字符串表示。
- 覆盖:
- 类 Object 中的
toString