- java.lang.Object
-
- java.util.AbstractCollection<E>
-
- java.util.AbstractList<E>
-
- java.util.Vector<E>
-
- 参数类型
-
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
。 因此,在并发修改的情况下,迭代器快速而干净地失败,而不是在未来的未确定时间冒任意,非确定性行为的风险。 该Enumerations
由返回elements
方法不是快速失败的; 如果在创建枚举后的任何时候对Vector进行结构修改,则枚举的结果是未定义的。请注意,迭代器的快速失败行为无法得到保证,因为一般来说,在存在不同步的并发修改时,不可能做出任何硬性保证。 失败快速迭代器以尽力而为的方式抛出
ConcurrentModificationException
。 因此,编写依赖于此异常的程序以确保其正确性是错误的: 迭代器的快速失败行为应该仅用于检测错误。从Java 2平台v1.2开始,该类被改进以实现
List
接口,使其成为Java Collections Framework的成员。 与新的集合实现不同,Vector
是同步的。 如果不需要线程安全实现,建议使用ArrayList
代替Vector
。- 从以下版本开始:
- 1.0
- 另请参见:
-
Collection
,LinkedList
, Serialized Form
-
-
字段汇总
字段 变量和类型 字段 描述 protected int
capacityIncrement
当矢量大小超过其容量时,矢量容量自动递增的量。protected int
elementCount
此Vector
对象中的有效组件数。protected Object[]
elementData
存储向量组件的数组缓冲区。-
声明的属性在类 java.util.AbstractList
modCount
-
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 void
add(int index, E element)
将指定元素插入此Vector中的指定位置。boolean
add(E e)
将指定的元素追加到此Vector的末尾。boolean
addAll(int index, Collection<? extends E> c)
将指定Collection中的所有元素插入到此Vector中的指定位置。boolean
addAll(Collection<? extends E> c)
将指定Collection中的所有元素追加到此Vector的末尾,按照指定Collection的Iterator返回的顺序。void
addElement(E obj)
将指定的组件添加到此向量的末尾,将其大小增加1。int
capacity()
返回此向量的当前容量。void
clear()
从此Vector中删除所有元素。Object
clone()
返回此向量的副本。boolean
contains(Object o)
如果此向量包含指定的元素,则返回true
。boolean
containsAll(Collection<?> c)
如果此Vector包含指定Collection中的所有元素,则返回true。void
copyInto(Object[] anArray)
将此向量的组件复制到指定的数组中。E
elementAt(int index)
返回指定索引处的组件。Enumeration<E>
elements()
返回此向量的组件的枚举。void
ensureCapacity(int minCapacity)
如有必要,增加此向量的容量,以确保它至少可以容纳由minimum capacity参数指定的组件数。boolean
equals(Object o)
将指定的Object与此Vector进行比较以获得相等性。E
firstElement()
返回此向量的第一个组件(索引0
处的项)。void
forEach(Consumer<? super E> action)
对Iterable
每个元素执行给定操作,直到处理Iterable
所有元素或操作引发异常。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()
测试此向量是否没有组件。Iterator<E>
iterator()
以适当的顺序返回此列表中元素的迭代器。E
lastElement()
返回向量的最后一个组件。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)
删除此Vector中指定位置的元素。boolean
remove(Object o)
删除此向量中第一次出现的指定元素如果向量不包含该元素,则不会更改。boolean
removeAll(Collection<?> c)
从此Vector中删除指定Collection中包含的所有元素。void
removeAllElements()
从此向量中移除所有组件并将其大小设置为零。boolean
removeElement(Object obj)
从此向量中移除参数的第一个(索引最低)事件。void
removeElementAt(int index)
删除指定索引处的组件。boolean
removeIf(Predicate<? super E> filter)
删除此集合中满足给定谓词的所有元素。protected void
removeRange(int fromIndex, int toIndex)
从此列表中删除索引介于fromIndex
(含)和toIndex
(独占)之间的所有元素。void
replaceAll(UnaryOperator<E> operator)
将该列表的每个元素替换为将运算符应用于该元素的结果。boolean
retainAll(Collection<?> c)
仅保留此Vector中包含在指定Collection中的元素。E
set(int index, E element)
用指定的元素替换此Vector中指定位置的元素。void
setElementAt(E obj, int index)
将此向量的指定index
处的组件设置为指定对象。void
setSize(int newSize)
设置此向量的大小。int
size()
返回此向量中的组件数。Spliterator<E>
spliterator()
在此列表中的元素上创建late-binding和失败快速Spliterator
。List<E>
subList(int fromIndex, int toIndex)
返回此List的部分在fromIndex(包含)和toIndex(独占)之间的视图。Object[]
toArray()
以正确的顺序返回包含此Vector中所有元素的数组。<T> T[]
toArray(T[] a)
以正确的顺序返回包含此Vector中所有元素的数组; 返回数组的运行时类型是指定数组的运行时类型。String
toString()
返回此Vector的字符串表示形式,包含每个元素的String表示形式。void
trimToSize()
修剪此向量的容量为向量的当前大小。-
声明方法的接口 java.util.Collection
parallelStream, stream, toArray
-
-
-
-
字段详细信息
-
elementData
protected Object[] elementData
存储向量组件的数组缓冲区。 向量的容量是此数组缓冲区的长度,并且至少足以包含所有向量的元素。Vector中最后一个元素后面的任何数组元素都是null。
-
elementCount
protected int elementCount
此Vector
对象中的有效组件数。 组件elementData[0]
到elementData[elementCount-1]
是实际的项目。
-
capacityIncrement
protected int capacityIncrement
当矢量大小超过其容量时,矢量容量自动递增的量。 如果容量增量小于或等于零,则每次需要增长时,矢量的容量加倍。
-
-
构造方法详细信息
-
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)
按照集合的迭代器返回的顺序构造一个包含指定集合元素的向量。- 参数
-
c
-c
元素放入此向量的集合 - 异常
-
NullPointerException
- 如果指定的集合为null - 从以下版本开始:
- 1.2
-
-
方法详细信息
-
copyInto
public void copyInto(Object[] anArray)
将此向量的组件复制到指定的数组中。 在索引项k
该向量被复制到部件k
的anArray
。- 参数
-
anArray
- 组件复制到的数组 - 异常
-
NullPointerException
- 如果给定数组为null -
IndexOutOfBoundsException
- 如果指定的数组不足以容纳此向量的所有组件 -
ArrayStoreException
- 如果此向量的组件不是可以存储在指定数组中的运行时类型 - 另请参见:
-
toArray(Object[])
-
trimToSize
public void trimToSize()
修剪此向量的容量为向量的当前大小。 如果此向量的容量大于其当前大小,则通过将字段elementData
保留的内部数据数组替换为较小的容量,将容量更改为等于大小。 应用程序可以使用此操作来最小化向量的存储。
-
ensureCapacity
public void ensureCapacity(int minCapacity)
如有必要,增加此向量的容量,以确保它至少可以容纳由minimum capacity参数指定的组件数。如果此向量的当前容量小于
minCapacity
,则通过将更大的内部数据阵列保留在字段elementData
来增加其容量。 新的数据阵列的大小将是原来的大小加上capacityIncrement
,除非的值capacityIncrement
小于或等于零,在这种情况下,新的容量将是原来容量的两倍; 但如果这个新尺寸仍小于minCapacity
,则新容量将为minCapacity
。- 参数
-
minCapacity
- 所需的最小容量
-
setSize
public void setSize(int newSize)
设置此向量的大小。 如果新大小大于当前大小,null
在向量的末尾添加新的null
项。 如果新大小小于当前大小,则丢弃索引为newSize
或更大的所有组件。- 参数
-
newSize
- 此向量的新大小 - 异常
-
ArrayIndexOutOfBoundsException
- 如果新大小为负数
-
capacity
public int capacity()
返回此向量的当前容量。- 结果
- 当前容量(其内部数据数组的长度,保存在此向量的字段
elementData
中)
-
size
public int size()
返回此向量中的组件数。
-
isEmpty
public boolean isEmpty()
测试此向量是否没有组件。- Specified by:
-
isEmpty
在界面Collection<E>
- Specified by:
-
isEmpty
在界面List<E>
- 重写:
-
isEmpty
在类AbstractCollection<E>
- 结果
-
true
当且仅当此向量没有组件时,即其大小为零; 否则为false
。
-
elements
public Enumeration<E> elements()
返回此向量的组件的枚举。 返回的Enumeration
对象将生成此向量中的所有项目。 生成的第一个项目是索引0
处的项目,然后是索引1
处的项目,依此类推。 如果在枚举元素的同时对结构进行了结构修改,则枚举的结果是未定义的。- 结果
- 这个向量的组件的枚举
- 另请参见:
-
Iterator
-
contains
public boolean contains(Object o)
如果此向量包含指定的元素,则返回true
。 更正式地,返回true
当且仅当此向量包含至少一个元素e
Objects.equals(o, e)
。- Specified by:
-
contains
接口Collection<E>
- Specified by:
-
contains
在界面List<E>
- 重写:
-
contains
在类AbstractCollection<E>
- 参数
-
o
- 要测试其在此向量中的存在的元素 - 结果
-
true
如果此向量包含指定的元素
-
indexOf
public int indexOf(Object o)
返回此向量中第一次出现的指定元素的索引,如果此向量不包含该元素,则返回-1。 更正式地,返回最低指数i
如Objects.equals(o, get(i))
,如果没有这样的指数,则返回-1。
-
indexOf
public int indexOf(Object o, int index)
返回此向量中第一次出现的指定元素的索引,从index
搜索向前,或者如果找不到该元素则返回-1。 更正式的是,返回最低指数i
如(i >= index && Objects.equals(o, get(i)))
,如果没有这样的指数则返回-1。- 参数
-
o
- 要搜索的元素 -
index
- 开始搜索的索引 - 结果
- 此向量中元素在位置
index
或更高位置的第一次出现的索引;-1
如果找不到该元素。 - 异常
-
IndexOutOfBoundsException
- 如果指定的索引为负数 - 另请参见:
-
Object.equals(Object)
-
lastIndexOf
public int lastIndexOf(Object o)
返回此向量中指定元素最后一次出现的索引,如果此向量不包含该元素,则返回-1。 更正式地说,返回最高指数i
如Objects.equals(o, get(i))
,如果没有这样的指数则返回-1。- Specified by:
-
lastIndexOf
在界面List<E>
- 重写:
-
lastIndexOf
在类AbstractList<E>
- 参数
-
o
- 要搜索的元素 - 结果
- 此向量中指定元素最后一次出现的索引,如果此向量不包含该元素,则返回-1
-
lastIndexOf
public int lastIndexOf(Object o, int index)
返回此向量中最后一次出现的指定元素的索引,从index
向后搜索,如果找不到该元素,则返回-1。 更正式的是,返回最高指数i
如(i <= index && Objects.equals(o, get(i)))
,如果没有这样的指数则返回-1。- 参数
-
o
- 要搜索的元素 -
index
- 开始向后搜索的索引 - 结果
- 此向量中位置小于或等于
index
的元素的最后一次出现的索引; 如果找不到元素,则返回-1。 - 异常
-
IndexOutOfBoundsException
- 如果指定的索引大于或等于此向量的当前大小
-
elementAt
public E elementAt(int index)
- 参数
-
index
- 此向量的索引 - 结果
- 指定索引处的组件
- 异常
-
ArrayIndexOutOfBoundsException
- 如果指数超出范围(index < 0 || index >= size()
)
-
firstElement
public E firstElement()
返回此向量的第一个组件(索引为0
的项)。- 结果
- 这个载体的第一个组成部分
- 异常
-
NoSuchElementException
- 如果此向量没有组件
-
lastElement
public E lastElement()
返回向量的最后一个组件。- 结果
- 向量的最后一个组成部分,即索引为
size() - 1
的组件 - 异常
-
NoSuchElementException
- 如果此向量为空
-
setElementAt
public void setElementAt(E obj, int index)
将此向量的指定index
处的组件设置为指定对象。 该位置的前一个组件将被丢弃。索引必须是大于或等于
0
且小于向量当前大小的值。此方法的功能与
set(int, E)
方法(List
接口的一部分)相同。 请注意,set
方法会反转参数的顺序,以更接近地匹配数组使用情况。 另请注意,set
方法返回存储在指定位置的旧值。- 参数
-
obj
-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。)此方法的功能与
add(int, E)
方法(List
接口的一部分)相同。 请注意,add
方法会反转参数的顺序,以更接近地匹配数组使用情况。- 参数
-
obj
- 要插入的组件 -
index
- 插入新组件的位置 - 异常
-
ArrayIndexOutOfBoundsException
- 如果指数超出范围(index < 0 || index > size()
)
-
addElement
public void addElement(E obj)
- 参数
-
obj
- 要添加的组件
-
removeElement
public boolean removeElement(Object obj)
从此向量中移除参数的第一个(索引最低)事件。 如果在此向量中找到对象,则向量中具有大于或等于对象索引的索引的每个组件向下移动以使索引1小于其先前的值。此方法的功能与
remove(Object)
方法(List
接口的一部分)相同。- 参数
-
obj
- 要删除的组件 - 结果
-
true
如果参数是该向量的一个组成部分; 否则为false
。
-
removeAllElements
public void removeAllElements()
-
clone
public Object clone()
返回此向量的副本。 该副本将包含对内部数据数组的克隆的引用,而不是对此Vector
对象的原始内部数据数组的Vector
。
-
toArray
public Object[] toArray()
以正确的顺序返回包含此Vector中所有元素的数组。- Specified by:
-
toArray
在界面Collection<E>
- Specified by:
-
toArray
在界面List<E>
- 重写:
-
toArray
在类AbstractCollection<E>
- 结果
- 一个数组,其 runtime component type是
Object
,包含此集合中的所有元素 - 从以下版本开始:
- 1.2
- 另请参见:
-
Arrays.asList(Object[])
-
toArray
public <T> T[] toArray(T[] a)
以正确的顺序返回包含此Vector中所有元素的数组; 返回数组的运行时类型是指定数组的运行时类型。 如果Vector适合指定的数组,则返回其中。 否则,将使用指定数组的运行时类型和此Vector的大小分配新数组。如果Vector适合指定的数组,并且有空余空间(即数组中的元素多于Vector),则紧跟Vector结尾的数组中的元素将设置为null。 ( 仅当调用者知道Vector不包含任何null元素时,这在确定Vector的长度时很有用。)
- Specified by:
-
toArray
在界面Collection<E>
- Specified by:
-
toArray
在界面List<E>
- 重写:
-
toArray
在类AbstractCollection<E>
- 参数类型
-
T
- 数组元素的类型。 与<E>
相同或超类型为<E>
。 - 参数
-
a
- 要存储Vector元素的数组(如果它足够大); 否则,为此目的分配相同运行时类型的新数组。 - 结果
- 包含Vector元素的数组
- 异常
-
ArrayStoreException
- 如果a的运行时类型<T>
不是此向量中每个元素的运行时类型的超类型<E>
-
NullPointerException
- 如果给定数组为null - 从以下版本开始:
- 1.2
-
get
public E get(int index)
返回此Vector中指定位置的元素。- Specified by:
-
get
在界面List<E>
- Specified by:
-
get
在类AbstractList<E>
- 参数
-
index
- 要返回的元素的索引 - 结果
- 指定索引处的对象
- 异常
-
ArrayIndexOutOfBoundsException
- 如果指数超出范围(index < 0 || index >= size()
) - 从以下版本开始:
- 1.2
-
set
public E set(int index, E element)
用指定的元素替换此Vector中指定位置的元素。- Specified by:
-
set
在界面List<E>
- 重写:
-
set
在类AbstractList<E>
- 参数
-
index
- 要替换的元素的索引 -
element
- 要存储在指定位置的元素 - 结果
- 先前在指定位置的元素
- 异常
-
ArrayIndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= size()
) - 从以下版本开始:
- 1.2
-
add
public boolean add(E e)
将指定的元素追加到此Vector的末尾。- Specified by:
-
add
在界面Collection<E>
- Specified by:
-
add
在界面List<E>
- 重写:
-
add
在类AbstractList<E>
- 参数
-
e
- 要附加到此Vector的元素 - 结果
-
true
(由Collection.add(E)
指定) - 从以下版本开始:
- 1.2
-
remove
public boolean remove(Object o)
删除此向量中第一次出现的指定元素如果向量不包含该元素,则不会更改。 更正式地,删除具有最低索引i的元素,使得Objects.equals(o, get(i))
(如果存在这样的元素)。- Specified by:
-
remove
在界面Collection<E>
- Specified by:
-
remove
in interfaceList<E>
- 重写:
-
remove
在类AbstractCollection<E>
- 参数
-
o
- 要从此Vector中移除的元素(如果存在) - 结果
- 如果Vector包含指定的元素,则为true
- 从以下版本开始:
- 1.2
-
add
public void add(int index, E element)
将指定元素插入此Vector中的指定位置。 将当前位置的元素(如果有)和任何后续元素向右移动(将其添加到索引中)。- Specified by:
-
add
在界面List<E>
- 重写:
-
add
在类AbstractList<E>
- 参数
-
index
- 要插入指定元素的索引 -
element
- 要插入的元素 - 异常
-
ArrayIndexOutOfBoundsException
- 如果指数超出范围(index < 0 || index > size()
) - 从以下版本开始:
- 1.2
-
remove
public E remove(int index)
删除此Vector中指定位置的元素。 将任何后续元素向左移位(从索引中减去一个元素)。 返回从Vector中删除的元素。- Specified by:
-
remove
在界面List<E>
- 重写:
-
remove
在AbstractList<E>
类 - 参数
-
index
- 要删除的元素的索引 - 结果
- 被删除的元素
- 异常
-
ArrayIndexOutOfBoundsException
- 如果指数超出范围(index < 0 || index >= size()
) - 从以下版本开始:
- 1.2
-
clear
public void clear()
从此Vector中删除所有元素。 此调用返回后,Vector将为空(除非它抛出异常)。- Specified by:
-
clear
在界面Collection<E>
- Specified by:
-
clear
在界面List<E>
- 重写:
-
clear
在类AbstractList<E>
- 从以下版本开始:
- 1.2
-
containsAll
public boolean containsAll(Collection<?> c)
如果此Vector包含指定Collection中的所有元素,则返回true。- Specified by:
-
containsAll
在界面Collection<E>
- Specified by:
-
containsAll
在界面List<E>
- 重写:
-
containsAll
在类AbstractCollection<E>
- 参数
-
c
- 一个集合,其元素将在此向量中进行包含测试 - 结果
- 如果此Vector包含指定集合中的所有元素,则返回true
- 异常
-
NullPointerException
- 如果指定的集合为null - 另请参见:
-
AbstractCollection.contains(Object)
-
addAll
public boolean addAll(Collection<? extends E> c)
将指定Collection中的所有元素追加到此Vector的末尾,按照指定Collection的Iterator返回的顺序。 如果在操作正在进行时修改了指定的Collection,则此操作的行为是不确定的。 (这意味着如果指定的Collection是此Vector,则此调用的行为是未定义的,并且此Vector非空。)- Specified by:
-
addAll
在界面Collection<E>
- Specified by:
-
addAll
在界面List<E>
- 重写:
-
addAll
在类AbstractCollection<E>
- 参数
-
c
- 要插入此Vector的元素 - 结果
-
true
如果此向量因调用而更改 - 异常
-
NullPointerException
- 如果指定的集合为null - 从以下版本开始:
- 1.2
- 另请参见:
-
AbstractCollection.add(Object)
-
removeAll
public boolean removeAll(Collection<?> c)
从此Vector中删除指定Collection中包含的所有元素。- Specified by:
-
removeAll
在界面Collection<E>
- Specified by:
-
removeAll
在界面List<E>
- 重写:
-
removeAll
在类AbstractCollection<E>
- 参数
-
c
- 要从Vector中删除的元素的集合 - 结果
- 如果此向量因调用而更改,则为true
- 异常
-
ClassCastException
- 如果此向量中的一个或多个元素的类型与指定的集合不兼容( optional ) -
NullPointerException
- 如果此向量包含一个或多个null元素且指定的集合不支持null元素( optional ),或者指定的集合为null - 从以下版本开始:
- 1.2
- 另请参见:
-
AbstractCollection.remove(Object)
,AbstractCollection.contains(Object)
-
retainAll
public boolean retainAll(Collection<?> c)
仅保留此Vector中包含在指定Collection中的元素。 换句话说,从此Vector中删除未包含在指定Collection中的所有元素。- Specified by:
-
retainAll
在界面Collection<E>
- Specified by:
-
retainAll
在界面List<E>
- 重写:
-
retainAll
在类AbstractCollection<E>
- 参数
-
c
- 要在此Vector中保留的元素集合(删除所有其他元素) - 结果
- 如果此向量因调用而更改,则为true
- 异常
-
ClassCastException
- 如果此向量中的一个或多个元素的类型与指定的集合不兼容( optional ) -
NullPointerException
- 如果此向量包含一个或多个null元素且指定的集合不支持null元素( optional ),或者指定的集合为null - 从以下版本开始:
- 1.2
- 另请参见:
-
AbstractCollection.remove(Object)
,AbstractCollection.contains(Object)
-
removeIf
public boolean removeIf(Predicate<? super E> filter)
从界面复制的说明:Collection
删除此集合中满足给定谓词的所有元素。 在迭代期间或通过谓词抛出的错误或运行时异常被中继到调用者。- Specified by:
-
removeIf
接口Collection<E>
- 参数
-
filter
- 一个谓词,它返回true
表示要删除的元素 - 结果
-
true
如果删除了任何元素 - 异常
-
NullPointerException
- 如果指定的过滤器为null
-
addAll
public boolean addAll(int index, Collection<? extends E> c)
将指定Collection中的所有元素插入到此Vector中的指定位置。 将当前位置的元素(如果有)和任何后续元素向右移动(增加其索引)。 新元素将按照指定Collection的迭代器返回的顺序出现在Vector中。- Specified by:
-
addAll
在界面List<E>
- 重写:
-
addAll
在类AbstractList<E>
- 参数
-
index
- 从指定集合插入第一个元素的索引 -
c
- 要插入此Vector中的元素 - 结果
-
true
如果此向量因调用而更改 - 异常
-
ArrayIndexOutOfBoundsException
- 如果指数超出范围(index < 0 || index > size()
) -
NullPointerException
- 如果指定的集合为null - 从以下版本开始:
- 1.2
-
equals
public boolean equals(Object o)
将指定的Object与此Vector进行比较以获得相等性。 当且仅当指定的Object也是List时,返回true,两个列表具有相同的大小,并且两个列表中的所有对应元素对都相等 。 (两个元件e1
和e2
是如果相等Objects.equals(e1, e2)
)。换句话说,两个列表被定义为等于如果它们包含以相同的顺序相同的元件。- Specified by:
-
equals
在界面Collection<E>
- Specified by:
-
equals
在界面List<E>
- 重写:
-
equals
在类AbstractList<E>
- 参数
-
o
- 要与此Vector进行相等性比较的对象 - 结果
- 如果指定的Object等于此Vector,则返回true
- 另请参见:
-
Object.hashCode()
,HashMap
-
hashCode
public int hashCode()
返回此Vector的哈希码值。- Specified by:
-
hashCode
在界面Collection<E>
- Specified by:
-
hashCode
在界面List<E>
- 重写:
-
hashCode
在类AbstractList<E>
- 结果
- 此列表的哈希码值
- 另请参见:
-
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
toString
public String toString()
返回此Vector的字符串表示形式,包含每个元素的String表示形式。- 重写:
-
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的操作都可以通过操作subList视图而不是整个List来用作范围操作。 例如,以下习语从List中删除了一系列元素:
list.subList(from, to).clear();
可以为indexOf和lastIndexOf构造类似的习语,并且可以将Collections类中的所有算法应用于subList。如果支持列表(即此List)在结构上以除了返回List之外的任何方式进行变量 ,则此方法返回的List的语义将变为未定义。 (结构修改是那些改变列表大小的修改,或以其他方式扰乱它,使得正在进行的迭代可能产生不正确的结果。)
- Specified by:
-
subList
在界面List<E>
- 重写:
-
subList
在类AbstractList<E>
- 参数
-
fromIndex
-fromIndex
低端点(包括) -
toIndex
-toIndex
高端点(不包括) - 结果
- 此列表中指定范围的视图
- 异常
-
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的元素。返回的列表迭代器是fail-fast 。
- Specified by:
-
listIterator
在界面List<E>
- 重写:
-
listIterator
,类AbstractList<E>
- 参数
-
index
- 从列表迭代器返回的第一个元素的索引(通过调用next
) - 结果
- 列表中元素的列表迭代器(按正确顺序),从列表中的指定位置开始
- 异常
-
IndexOutOfBoundsException
- 如果指数超出范围(index < 0 || index > size()
)
-
listIterator
public ListIterator<E> listIterator()
返回此列表中元素的列表迭代器(按适当顺序)。返回的列表迭代器是fail-fast 。
- Specified by:
-
listIterator
在界面List<E>
- 重写:
-
listIterator
类AbstractList<E>
- 结果
- 列表中的元素列表迭代器(按正确顺序)
- 另请参见:
-
listIterator(int)
-
forEach
public void forEach(Consumer<? super E> action)
从界面复制的说明:Iterable
对Iterable
每个元素执行给定操作,直到处理Iterable
所有元素或操作抛出异常为止。 如果指定了该顺序,则按迭代顺序执行操作。 操作抛出的异常将转发给调用者。如果操作执行修改元素的基础源的副作用,则此方法的行为未指定,除非重写类已指定并发修改策略。
- Specified by:
-
forEach
接口Iterable<E>
- 参数
-
action
- 要为每个元素执行的操作 - 异常
-
NullPointerException
- 如果指定的操作为null
-
replaceAll
public void replaceAll(UnaryOperator<E> operator)
从界面复制的说明:List
将该列表的每个元素替换为将运算符应用于该元素的结果。 操作员抛出的错误或运行时异常将转发给调用者。- Specified by:
-
replaceAll
在界面List<E>
- 参数
-
operator
- 要应用于每个元素的运算符 - 异常
-
NullPointerException
- 如果指定的运算符为null或运算符结果为空值且此列表不允许空元素( optional )
-
spliterator
public Spliterator<E> spliterator()
在此列表中的元素上创建late-binding和故障快速Spliterator
。该
Spliterator
报告Spliterator.SIZED
,Spliterator.SUBSIZED
和Spliterator.ORDERED
。 覆盖实现应记录其他特征值的报告。- Specified by:
-
spliterator
在界面Collection<E>
- Specified by:
-
spliterator
在界面Iterable<E>
- Specified by:
-
spliterator
接口List<E>
- 结果
- a
Spliterator
在此列表中的元素上 - 从以下版本开始:
- 1.8
-
-