Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Vector<E> extends AbstractList<E> implements List<E>, RandomAccess, Cloneable, Serializable
Vector
класс реализует growable массив объектов. Как массив, это содержит компоненты, к которым можно получить доступ, используя целочисленный индекс. Однако, размер a Vector
может вырасти или уменьшиться как необходимый разместить добавление и удаление элементов после Vector
был создан. Каждый вектор пытается оптимизировать управление хранением, поддерживая a capacity
и a capacityIncrement
. capacity
является всегда, по крайней мере, столь же большим как векторный размер; это обычно больше, потому что, поскольку компоненты добавляются к вектору, увеличениям хранения вектора блоков размер capacityIncrement
. Приложение может увеличить емкость вектора прежде, чем вставить большое количество компонентов; это уменьшает количество инкрементного перераспределения.
iterators возвратился этим классом iterator
и listIterator
методы являются сбоем быстро: если вектор структурно изменяется когда-либо после того, как iterator создается, всегда кроме через собственный iterator's remove
или add
методы, iterator бросит a ConcurrentModificationException
. Таким образом, перед лицом параллельной модификации, iterator перестал работать быстро и чисто, вместо того, чтобы рискнуть произвольным, недетерминированным поведением в неопределенное время в будущем. Enumerations
возвращенный elements
метод не является сбоем быстро.
Отметьте, что поведение сбоя быстро iterator не может быть гарантировано, как, вообще говоря, невозможно сделать любые трудные гарантии в присутствии несинхронизируемой параллельной модификации. Приведите бросок iterators к сбою быстро ConcurrentModificationException
на основе максимальных усилий. Поэтому, было бы неправильно записать программу, которая зависела от этого исключения для его правильности: поведение сбоя быстро iterators должно использоваться только, чтобы обнаружить ошибки.
С Java 2 платформы v1.2, этот класс был retrofitted, чтобы реализовать List
интерфейс, делая это элемент Платформы Наборов Java. В отличие от новых реализаций набора, Vector
синхронизируется. Если ориентированная на многопотоковое исполнение реализация не необходима, рекомендуется использовать ArrayList
вместо Vector
.
Collection
, LinkedList
, Сериализированная ФормаМодификатор и Тип | Поле и Описание |
---|---|
protected int |
capacityIncrement
Количество, которым автоматически постепенно увеличивается емкость вектора, когда его размер становится больше чем его емкость.
|
protected int |
elementCount
Число допустимых компонентов в этом
Vector объект. |
protected Object[] |
elementData
Буфер массива, в который сохранены компоненты вектора.
|
modCount
Конструктор и Описание |
---|
Vector()
Создает пустой вектор так, чтобы у его внутреннего массива данных был размер
10 и его стандартный инкремент емкости является нулем. |
Vector(Collection<? extends E> c)
Создает вектор, содержащий элементы указанного набора, в порядке, они возвращаются iterator набора.
|
Vector(int initialCapacity)
Создает пустой вектор с указанной начальной емкостью, и с ее емкостью постепенно увеличиваются равный нулю.
|
Vector(int initialCapacity, int capacityIncrement)
Создает пустой вектор с указанным начальным инкрементом емкости и емкости.
|
Модификатор и Тип | Метод и Описание |
---|---|
boolean |
add(E e)
Добавляет указанный элемент до конца этого Вектора.
|
void |
add(int index, E element)
Вставляет указанный элемент в указанной позиции в этом Векторе.
|
boolean |
addAll(Collection<? extends E> c)
Добавляет все элементы в указанном Наборе до конца этого Вектора, в порядке, что они возвращаются Iterator указанного Набора.
|
boolean |
addAll(int index, Collection<? extends E> c)
Вставляет все элементы в указанном Наборе в этот Вектор в указанной позиции.
|
void |
addElement(E obj)
Добавляет указанный компонент до конца этого вектора, увеличивая его размер одним.
|
int |
capacity()
Возвращает текущую емкость этого вектора.
|
void |
clear()
Удаляет все элементы от этого Вектора.
|
Объект |
clone()
Возвращает клона этого вектора.
|
boolean |
contains(Object o)
Возвраты
true если этот вектор содержит указанный элемент. |
boolean |
containsAll(Collection<?> c)
Возвращает true, если этот Вектор содержит все элементы в указанном Наборе.
|
void |
copyInto(Object[] anArray)
Копирует компоненты этого вектора в указанный массив.
|
E |
elementAt(int index)
Возвращает компонент по указанному индексу.
|
Enumeration<E> |
elements()
Возвращает перечисление компонентов этого вектора.
|
void |
ensureCapacity(int minCapacity)
Увеличивает емкость этого вектора, в случае необходимости, чтобы гарантировать, что это может содержать, по крайней мере, число компонентов, определенных минимальным параметром емкости.
|
boolean |
equals(Object o)
Сравнивает указанный Объект с этим Вектором для равенства.
|
E |
firstElement()
Возвращает первый компонент (элемент по индексу
0 ) из этого вектора. |
E |
get(int index)
Возвращает элемент в указанной позиции в этом Векторе.
|
int |
hashCode()
Возвращает значение хэш-кода для этого Вектора.
|
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()
Возвращает iterator по элементам в этом списке в надлежащей последовательности.
|
E |
lastElement()
Возвращает последний компонент вектора.
|
int |
lastIndexOf(Object o)
Возвращает индекс последнего вхождения указанного элемента в этом векторе, или-1, если этот вектор не содержит элемент.
|
int |
lastIndexOf(Object o, int index)
Возвращает индекс последнего вхождения указанного элемента в этом векторе, ища назад от
index , или возвраты-1, если элемент не находится. |
ListIterator<E> |
listIterator()
Возвращает список iterator по элементам в этом списке (в надлежащей последовательности).
|
ListIterator<E> |
listIterator(int index)
Возвращает список iterator по элементам в этом списке (в надлежащей последовательности), запускаясь в указанной позиции в списке.
|
E |
remove(int index)
Удаляет элемент в указанной позиции в этом Векторе.
|
boolean |
remove(Object o)
Удаляет первое возникновение указанного элемента в этом Векторе, Если Вектор не содержит элемент, это неизменно.
|
boolean |
removeAll(Collection<?> c)
Удаляет из этого Вектора все его элементы, которые содержатся в указанном Наборе.
|
void |
removeAllElements()
Удаляет все компоненты из этого вектора и обнуляет его размер.
|
boolean |
removeElement(Object obj)
Удаляет первое (индексированное самым низким образом) возникновение параметра от этого вектора.
|
void |
removeElementAt(int index)
Удаляет компонент по указанному индексу.
|
protected void |
removeRange(int fromIndex, int toIndex)
Удаляет из этого списка все элементы, индекс которых между
fromIndex , включительно, и toIndex , монопольный. |
boolean |
retainAll(Collection<?> c)
Сохраняет только элементы в этом Векторе, которые содержатся в указанном Наборе.
|
E |
set(int index, E element)
Заменяет элемент в указанной позиции в этом Векторе с указанным элементом.
|
void |
setElementAt(E obj, int index)
Устанавливает компонент в указанном
index из этого вектора, чтобы быть указанным объектом. |
void |
setSize(int newSize)
Устанавливает размер этого вектора.
|
int |
size()
Возвращает число компонентов в этом векторе.
|
List<E> |
subList(int fromIndex, int toIndex)
Возвращает представление части этого Списка между fromIndex, включительно, и toIndex, монопольным.
|
Объект[] |
toArray()
Возвращает массив, содержащий все элементы в этом Векторе в правильном порядке.
|
<T> T[] |
toArray(T[] a)
Возвращает массив, содержащий все элементы в этом Векторе в правильном порядке; тип времени выполнения возвращенного массива является типом указанного массива.
|
Строка |
toString()
Возвращает строковое представление этого Вектора, содержа Строковое представление каждого элемента.
|
void |
trimToSize()
Обрезает емкость этого вектора быть текущим размером вектора.
|
protected Object[] elementData
Любые элементы массива после последнего элемента в Векторе являются нулем.
protected int elementCount
Vector
объект. Компоненты elementData[0]
через elementData[elementCount-1]
фактические элементы.protected int capacityIncrement
public Vector(int initialCapacity, int capacityIncrement)
initialCapacity
- начальная емкость вектораcapacityIncrement
- количество, которым увеличивается емкость, когда вектор переполняетсяIllegalArgumentException
- если указанная начальная емкость отрицательнаpublic Vector(int initialCapacity)
initialCapacity
- начальная емкость вектораIllegalArgumentException
- если указанная начальная емкость отрицательнаpublic Vector()
10
и его стандартный инкремент емкости является нулем.public Vector(Collection<? extends E> c)
c
- набор, элементы которого должны быть помещены в этот векторNullPointerException
- если указанный набор является нулемpublic void copyInto(Object[] anArray)
k
в этом векторе копируется в компонент k
из anArray
.anArray
- массив, в который копируются компонентыNullPointerException
- если данный массив является нулемIndexOutOfBoundsException
- если указанный массив не является достаточно многочисленным, чтобы содержать все компоненты этого вектораArrayStoreException
- если компонент этого вектора не имеет типа времени выполнения, который может быть сохранен в указанном массивеtoArray(Object[])
public void trimToSize()
elementData
, с меньшим. Приложение может использовать эту работу, чтобы минимизировать хранение вектора.public void ensureCapacity(int minCapacity)
Если текущая емкость этого вектора является меньше чем minCapacity
, тогда его емкость увеличивается, заменяя его внутренний массив данных, сохраненный в поле elementData
, с большим. Размер нового массива данных будет старым размером плюс capacityIncrement
, если значение capacityIncrement
меньше чем или равно нулю, когда новая емкость будет дважды старой емкостью; но если этот новый размер все еще меньше чем minCapacity
, тогда новая емкость будет minCapacity
.
minCapacity
- требуемая минимальная емкостьpublic void setSize(int newSize)
null
элементы добавляются до конца вектора. Если новый размер является меньше чем текущий размер, все компоненты по индексу newSize
и больше отбрасываются.newSize
- новый размер этого вектораArrayIndexOutOfBoundsException
- если новый размер отрицателенpublic int capacity()
elementData
из этого вектора)public int size()
size
в интерфейсе Collection<E>
size
в интерфейсе List<E>
size
в классе AbstractCollection<E>
public boolean isEmpty()
isEmpty
в интерфейсе Collection<E>
isEmpty
в интерфейсе List<E>
isEmpty
в классе AbstractCollection<E>
true
если и только если у этого вектора нет никаких компонентов, то есть, его размер является нулем; false
иначе.public Enumeration<E> elements()
Enumeration
объект генерирует все элементы в этом векторе. Первый сгенерированный элемент является элементом по индексу 0
, тогда элемент по индексу 1
, и так далее.Iterator
public boolean contains(Object o)
true
если этот вектор содержит указанный элемент. Более формально, возвраты true
если и только если этот вектор содержит по крайней мере один элемент e
так, что (o==null ? e==null : o.equals(e)).contains
в интерфейсе Collection<E>
contains
в интерфейсе List<E>
contains
в классе AbstractCollection<E>
o
- элемент, присутствие которого в этом векторе должно быть протестированоtrue
если этот вектор содержит указанный элементpublic int indexOf(Object o)
i
так, что (o==null ? get(i)==null : o.equals(get(i))), или-1, если нет такого индекса.public int indexOf(Object o, int index)
index
, или возвраты-1, если элемент не находится. Более формально, возвращает самый низкий индекс i
так, что (i >= index && (o==null ? get(i)==null : o.equals(get(i)))), или-1, если нет такого индекса.o
- элемент, чтобы искатьindex
- индексируйте, чтобы начать искать отindex
или позже в векторе; -1
если элемент не находится.IndexOutOfBoundsException
- если указанный индекс отрицателенObject.equals(Object)
public int lastIndexOf(Object o)
i
так, что (o==null ? get(i)==null : o.equals(get(i))), или-1, если нет такого индекса.lastIndexOf
в интерфейсе List<E>
lastIndexOf
в классе AbstractList<E>
o
- элемент, чтобы искатьpublic int lastIndexOf(Object o, int index)
index
, или возвраты-1, если элемент не находится. Более формально, возвращает самый высокий индекс i
так, что (i <= index && (o==null ? get(i)==null : o.equals(get(i)))), или-1, если нет такого индекса.o
- элемент, чтобы искатьindex
- индексируйте, чтобы начать искать назад отindex
в этом векторе;-1, если элемент не находится.IndexOutOfBoundsException
- если указанный индекс больше чем или равен текущему размеру этого вектораpublic E elementAt(int index)
Этот метод идентичен в функциональности get(int)
метод (который является частью List
интерфейс).
index
- индекс в этот векторArrayIndexOutOfBoundsException
- если индекс испытывает недостаток диапазона (index < 0 || index >= size()
)public E firstElement()
0
) из этого вектора.NoSuchElementException
- если у этого вектора нет никаких компонентовpublic E lastElement()
size() - 1
.NoSuchElementException
- если этот вектор пустpublic void setElementAt(E obj, int index)
index
из этого вектора, чтобы быть указанным объектом. Предыдущий компонент в той позиции отбрасывается. Индекс должен быть значением, больше чем или равный 0
и меньше чем текущий размер вектора.
Этот метод идентичен в функциональности set(int, E)
метод (который является частью List
интерфейс). Отметьте что set
метод инвертирует порядок параметров, чтобы более близко соответствовать использование массива. Отметьте также что set
метод возвращает старое значение, которое было сохранено в указанной позиции.
obj
- во что должен быть установлен компонентindex
- указанный индексArrayIndexOutOfBoundsException
- если индекс испытывает недостаток диапазона (index < 0 || index >= size()
)public void removeElementAt(int index)
index
смещается вниз, чтобы иметь индекс одно меньшее чем значение, которое он имел ранее. Размер этого вектора уменьшается 1
. Индекс должен быть значением, больше чем или равный 0
и меньше чем текущий размер вектора.
Этот метод идентичен в функциональности remove(int)
метод (который является частью List
интерфейс). Отметьте что remove
метод возвращает старое значение, которое было сохранено в указанной позиции.
index
- индекс объекта удалитьArrayIndexOutOfBoundsException
- если индекс испытывает недостаток диапазона (index < 0 || index >= size()
)public void insertElementAt(E obj, int index)
index
. Каждый компонент в этом векторе с индексом, больше или равным указанному index
смещается вверх, чтобы иметь индекс одно большее чем значение, которое он имел ранее. Индекс должен быть значением, больше чем или равный 0
и меньше чем или равный текущему размеру вектора. (Если индекс равен текущему размеру вектора, новый элемент добавляется к Вектору.)
Этот метод идентичен в функциональности add(int, E)
метод (который является частью List
интерфейс). Отметьте что add
метод инвертирует порядок параметров, чтобы более близко соответствовать использование массива.
obj
- компонент, чтобы вставитьindex
- где вставить новый компонентArrayIndexOutOfBoundsException
- если индекс испытывает недостаток диапазона (index < 0 || index > size()
)public void addElement(E obj)
Этот метод идентичен в функциональности add(E)
метод (который является частью List
интерфейс).
obj
- компонент, который будет добавленpublic boolean removeElement(Object obj)
Этот метод идентичен в функциональности remove(Object)
метод (который является частью List
интерфейс).
obj
- компонент, который будет удаленtrue
если параметром был компонент этого вектора; false
иначе.public void removeAllElements()
public Object clone()
Vector
объект.public Object[] toArray()
toArray
в интерфейсе Collection<E>
toArray
в интерфейсе List<E>
toArray
в классе AbstractCollection<E>
Arrays.asList(Object[])
public <T> T[] toArray(T[] a)
Если Вектор помещается в указанный массив с комнатой, чтобы сэкономить (то есть, у массива есть больше элементов чем Вектор), элемент в массиве сразу после конца Вектора, устанавливают в NULL. (Это полезно в определении длины Вектора, только если вызывающая сторона знает, что Вектор не содержит нулевых элементов.)
toArray
в интерфейсе Collection<E>
toArray
в интерфейсе List<E>
toArray
в классе AbstractCollection<E>
a
- массив, в который должны быть сохранены элементы Вектора, если это является достаточно большим; иначе, новый массив того же самого типа времени выполнения выделяется с этой целью.ArrayStoreException
- если тип времени выполнения не супертип типа времени выполнения каждого элемента в этом ВектореNullPointerException
- если данный массив является нулемpublic E get(int index)
get
в интерфейсе List<E>
get
в классе AbstractList<E>
index
- индекс элемента, чтобы возвратитьсяArrayIndexOutOfBoundsException
- если индекс испытывает недостаток диапазона (index < 0 || index >= size()
)public E set(int index, E element)
set
в интерфейсе List<E>
set
в классе AbstractList<E>
index
- индекс элемента, чтобы заменитьelement
- элемент, который будет сохранен в указанной позицииArrayIndexOutOfBoundsException
- если индекс испытывает недостаток диапазона (index < 0 || index >= size()
)public boolean add(E e)
add
в интерфейсе Collection<E>
add
в интерфейсе List<E>
add
в классе AbstractList<E>
e
- элемент, который будет добавлен к этому Векторуtrue
(как определено Collection.add(E)
)public boolean remove(Object o)
(o==null ? get(i)==null : o.equals(get(i)))
(если такой элемент существует).remove
в интерфейсе Collection<E>
remove
в интерфейсе List<E>
remove
в классе AbstractCollection<E>
o
- элемент, который будет удален из этого Вектора, если существующийpublic void add(int index, E element)
add
в интерфейсе List<E>
add
в классе AbstractList<E>
index
- индекс, по которому должен быть вставлен указанный элементelement
- элемент, который будет вставленArrayIndexOutOfBoundsException
- если индекс испытывает недостаток диапазона (index < 0 || index > size()
)public E remove(int index)
remove
в интерфейсе List<E>
remove
в классе AbstractList<E>
index
- индекс элемента, который будет удаленArrayIndexOutOfBoundsException
- если индекс испытывает недостаток диапазона (index < 0 || index >= size()
)public void clear()
clear
в интерфейсе Collection<E>
clear
в интерфейсе List<E>
clear
в классе AbstractList<E>
public boolean containsAll(Collection<?> c)
containsAll
в интерфейсе Collection<E>
containsAll
в интерфейсе List<E>
containsAll
в классе AbstractCollection<E>
c
- набор, элементы которого будут протестированы на включение в этом ВектореNullPointerException
- если указанный набор является нулемAbstractCollection.contains(Object)
public boolean addAll(Collection<? extends E> c)
addAll
в интерфейсе Collection<E>
addAll
в интерфейсе List<E>
addAll
в классе AbstractCollection<E>
c
- элементы, которые будут вставлены в этот Векторtrue
если этот Вектор изменился в результате вызоваNullPointerException
- если указанный набор является нулемAbstractCollection.add(Object)
public boolean removeAll(Collection<?> c)
removeAll
в интерфейсе Collection<E>
removeAll
в интерфейсе List<E>
removeAll
в классе AbstractCollection<E>
c
- набор элементов, которые будут удалены из ВектораClassCastException
- если типы одного или более элементов в этом векторе являются несовместимыми с указанным (дополнительным) наборомNullPointerException
- если этот вектор содержит один или более нулевых элементов, и указанный набор не поддерживает нулевые (дополнительные) элементы, или если указанный набор является нулемAbstractCollection.remove(Object)
, AbstractCollection.contains(Object)
public boolean retainAll(Collection<?> c)
retainAll
в интерфейсе Collection<E>
retainAll
в интерфейсе List<E>
retainAll
в классе AbstractCollection<E>
c
- набор элементов, которые будут сохранены в этом Векторе (все другие элементы удаляются),ClassCastException
- если типы одного или более элементов в этом векторе являются несовместимыми с указанным (дополнительным) наборомNullPointerException
- если этот вектор содержит один или более нулевых элементов, и указанный набор не поддерживает нулевые (дополнительные) элементы, или если указанный набор является нулемAbstractCollection.remove(Object)
, AbstractCollection.contains(Object)
public boolean addAll(int index, Collection<? extends E> c)
addAll
в интерфейсе List<E>
addAll
в классе AbstractList<E>
index
- индекс, по которому можно вставить первый элемент от указанного набораc
- элементы, которые будут вставлены в этот Векторtrue
если этот Вектор изменился в результате вызоваArrayIndexOutOfBoundsException
- если индекс испытывает недостаток диапазона (index < 0 || index > size()
)NullPointerException
- если указанный набор является нулемpublic boolean equals(Object o)
e1
и e2
равны если (e1==null ? e2==null : e1.equals(e2))
.) Другими словами два Списка определяются, чтобы быть равными, если они содержат те же самые элементы в том же самом порядке.equals
в интерфейсе Collection<E>
equals
в интерфейсе List<E>
equals
в классе AbstractList<E>
o
- Объект, который будет сравнен для равенства с этим ВекторомObject.hashCode()
, HashMap
public int hashCode()
hashCode
в интерфейсе Collection<E>
hashCode
в интерфейсе List<E>
hashCode
в классе AbstractList<E>
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public String toString()
toString
в классе AbstractCollection<E>
public List<E> subList(int fromIndex, int toIndex)
Этот метод избавляет от необходимости явные операции диапазона (вида, которые обычно существуют для массивов). Любая работа, которая ожидает Список, может использоваться в качестве работы диапазона, работая на представлении подсписка вместо целого Списка. Например, следующая идиома удаляет диапазон элементов от Списка:
list.subList(from, to).clear();Подобные идиомы могут быть созданы для indexOf и lastIndexOf, и все алгоритмы в классе Наборов могут быть применены к подсписку.
Семантика Списка, возвращенного этим методом, становится неопределенной, если отступающий список (то есть, этот Список) структурно изменяются всегда кроме через возвращенный Список. (Структурные модификации - те, которые изменяют размер Списка, или иначе тревожат это таким способом, что происходящие итерации могут привести к неправильным результатам.)
subList
в интерфейсе List<E>
subList
в классе AbstractList<E>
fromIndex
- низкая конечная точка (включительно) подспискаtoIndex
- высокая конечная точка (монопольная) из подспискаIndexOutOfBoundsException
- если индексное значение конечной точки испытывает недостаток диапазона (fromIndex < 0 || toIndex > size)
IllegalArgumentException
- если индексы конечной точки не в порядке (fromIndex > toIndex)
protected void removeRange(int fromIndex, int toIndex)
fromIndex
, включительно, и toIndex
, монопольный. Сдвиги любые последующие элементы налево (уменьшает их индекс). Этот вызов сокращает список (toIndex - fromIndex)
элементы. (Если toIndex==fromIndex
, эта работа не имеет никакого эффекта.)removeRange
в классе AbstractList<E>
fromIndex
- индекс первого элемента, который будет удаленtoIndex
- индекс после последнего элемента, который будет удаленpublic ListIterator<E> listIterator(int index)
next
. Начальный вызов previous
возвратил бы элемент с указанным индексом минус один. Возвращенный список iterator является сбоем быстро.
listIterator
в интерфейсе List<E>
listIterator
в классе AbstractList<E>
index
- индекс первого элемента, который будет возвращен из списка iterator (звонком next
)IndexOutOfBoundsException
- если индекс испытывает недостаток диапазона (index < 0 || index > size()
)public ListIterator<E> listIterator()
Возвращенный список iterator является сбоем быстро.
listIterator
в интерфейсе List<E>
listIterator
в классе AbstractList<E>
listIterator(int)
public Iterator<E> iterator()
Возвращенный iterator является сбоем быстро.
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.