Класс Vector<E>

Класс Vector реализует увеличивающийся массив объектов. Как и массив, он содержит компоненты, к которым можно получить доступ с помощью целочисленного индекса. Однако размер Vector может увеличиваться или уменьшаться по мере необходимости для добавления и удаления элементов после создания Vector.

Каждый вектор пытается оптимизировать управление хранилищем, поддерживая capacity и capacityIncrement. capacity всегда не меньше размера вектора; обычно он больше, потому что по мере добавления компонентов в вектор хранилище вектора увеличивается порциями размером capacityIncrement. Приложение может увеличить емкость вектора перед вставкой большого количества компонентов; это уменьшает количество инкрементной перераспределения.

Итераторы, возвращаемые методами этого класса iterator и listIterator, являются быстродействующими: если вектор структурно изменяется в любой момент после создания итератора, каким-либо способом, кроме методов собственного итератора remove или add, итератор выбросит исключение ConcurrentModificationException. Таким образом, при одновременном изменении итератор быстро и четко завершает работу, а не рискует произвольным, непредсказуемым поведением в неопределенное время в будущем. Итератор Enumerations, возвращаемый методом elements, не является быстродействующим.

Обратите внимание, что поведение быстродействующего итератора нельзя гарантировать, поскольку в целом невозможно дать какие-либо гарантии в случае несинхронизированного одновременного изменения. Быстродействующие итераторы выбрасывают исключение ConcurrentModificationException в лучшем случае. Поэтому неправильно писать программу, которая полагалась бы на это исключение для своей корректности: поведение быстродействующих итераторов следует использовать только для обнаружения ошибок.

Начиная с платформы Java 2 v1.2, этот класс был переработан для реализации интерфейса List, что делает его членом Java Collections Framework. В отличие от новых реализаций коллекции, Vector синхронизирован. Если реализация, безопасная для потоков, не требуется, рекомендуется использовать ArrayList вместо Vector.

Поля

elementData

protected Object[] elementData

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 - набор, чьи элементы должны быть помещены в этот вектор

Исключения:

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)

Параметры:

minCapacity - желаемая минимальная ёмкость

setSize

public void setSize(int newSize)

Устанавливает размер этого вектора. Если новый размер больше текущего размера, новые null элементы добавляются в конец вектора. Если новый размер меньше текущего размера, все компоненты с индексом newSize и выше отбрасываются.

Параметры:

newSize - новый размер этого вектора

Исключения:

ArrayIndexOutOfBoundsException - если новый размер отрицательный

capacity

public int capacity()

Возвращает текущую ёмкость этого вектора.

Возвращает:

текущую ёмкость (длина внутреннего массива данных, хранящегося в поле elementData этого вектора)

size

public int size()

Возвращает количество компонентов в этом векторе.

Определено в:

size в интерфейсе Collection<E>

Определено в:

size в интерфейсе List<E>

Определено в:

size в классе AbstractCollection<E>

Возвращает:

количество компонентов в этом векторе

isEmpty

public boolean isEmpty()

Проверяет, не содержит ли этот вектор компонентов.

Определено в:

isEmpty в интерфейсе Collection<E>

Определено в:

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, такой, что (o==null ? e==null : o.equals(e)).

Определено в:

contains в интерфейсе Collection<E>

Определено в:

contains в интерфейсе List<E>

Переопределено в:

contains в классе AbstractCollection<E>

Параметры:

o - элемент, присутствие которого в этом векторе должно быть проверено

Возвращает:

true , если этот вектор содержит указанный элемент

indexOf

public int indexOf(Object o)

Возвращает индекс первого вхождения указанного элемента в этот вектор или -1, если этот вектор не содержит элемент. Более формально, возвращает наименьший индекс i, такой, что (o==null ? get(i)==null : o.equals(get(i))), или -1, если такого индекса нет.

Определено в:

indexOf в интерфейсе List<E>

Переопределено в:

indexOf в классе AbstractList<E>

Параметры:

o - искомый элемент

Возвращает:

индекс первого вхождения указанного элемента в этот вектор, или -1, если этот вектор не содержит элемент

indexOf

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)

lastIndexOf

public int lastIndexOf(Object o)

Возвращает индекс последнего вхождения указанного элемента в этот вектор или -1, если этот вектор не содержит элемент. Более формально, возвращает наибольший индекс i, такой, что (o==null ? get(i)==null : o.equals(get(i))), или -1, если такого индекса нет.

Определено в:

lastIndexOf в интерфейсе List<E>

Переопределено в:

lastIndexOf в классе AbstractList<E>

Параметры:

o - искомый элемент

Возвращает:

индекс последнего вхождения указанного элемента в этот вектор или -1, если этот вектор не содержит элемент

lastIndexOf

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 - если указанный индекс больше или равен текущему размеру этого вектора

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)

Параметры:

obj - значение, на которое нужно установить компонент

index - указанный индекс

Выбрасывает:

ArrayIndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= size())

removeElementAt

public void removeElementAt(int index)

Параметры:

index - индекс объекта для удаления

Выбрасывает:

ArrayIndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= size())

insertElementAt

public void insertElementAt(E obj,
                            int index)

Параметры:

obj - компонент для вставки

index - место для вставки нового компонента

Выбрасывает:

ArrayIndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index > size())

addElement

public void addElement(E obj)

Параметры:

obj - компонент, который нужно добавить

removeElement

public boolean removeElement(Object obj)

Параметры:

obj - компонент, который нужно удалить

Возвращает:

true если аргумент был компонентом этого вектора; false в противном случае.

removeAllElements

public void removeAllElements()

clone

public Object clone()

Возвращает копию этого вектора. Копия будет содержать ссылку на клон внутреннего массива данных, а не ссылку на исходный внутренний массив данных этого Vector объекта.

Переопределяет:

clone в классе Object

Возвращает:

клон этого вектора

См. также:

Cloneable

toArray

public Object[] toArray()

Возвращает массив, содержащий все элементы этого Vector в правильном порядке.

Указано в:

toArray в интерфейсе Collection<E>

Указано в:

toArray в интерфейсе List<E>

Переопределяет:

toArray в классе AbstractCollection<E>

Возвращает:

массив, содержащий все элементы этого набора

С:

1.2

См. также:

Arrays.asList(Object[])

toArray

public <T> T[] toArray(T[] a)

Указано в:

toArray в интерфейсе Collection<E>

Указано в:

toArray в интерфейсе List<E>

Переопределяет:

toArray в классе AbstractCollection<E>

Параметры типа:

T - тип времени выполнения массива, содержащего коллекцию

Параметры:

a - массив, в который должны быть помещены элементы Vector, если он достаточно велик; в противном случае для этой цели выделяется новый массив того же типа времени выполнения.

Возвращает:

массив, содержащий элементы Vector

Выбрасывает:

ArrayStoreException - если тип времени выполнения a не является надтипом типа времени выполнения каждого элемента в этом Vector

NullPointerException - если заданный массив равен null

С:

1.2

get

public E get(int index)

Возвращает элемент в указанной позиции в этом Vector.

Указано в:

get в интерфейсе List<E>

Указано в:

get в классе AbstractList<E>

Параметры:

index - индекс возвращаемого элемента

Возвращает:

объект в указанном индексе

Выбрасывает:

ArrayIndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= size())

С:

1.2

set

public E set(int index,
             E element)

Заменяет элемент в указанной позиции в этом Vector указанным элементом.

Указано в:

set в интерфейсе List<E>

Переопределяет:

set в классе AbstractList<E>

Параметры:

index - индекс заменяемого элемента

element - элемент, который нужно сохранить в указанной позиции

Возвращает:

элемент, ранее находившийся в указанной позиции

Выбрасывает:

ArrayIndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= size())

С:

1.2

add

public boolean add(E e)

Добавляет указанный элемент в конец этого Vector.

Указано в:

add в интерфейсе Collection<E>

Указано в:

add в интерфейсе List<E>

Переопределяет:

add в классе AbstractList<E>

Параметры:

e - элемент, который нужно добавить в этот Vector

Возвращает:

true (как указано в Collection.add(E))

С:

1.2

remove

public boolean remove(Object o)

Удаляет первое вхождение указанного элемента в этом Vector. Если Vector не содержит элемент, он не изменяется. Более формально, удаляет элемент с наименьшим индексом i, таким что (o==null ? get(i)==null : o.equals(get(i))), (если такой элемент существует).

Указано в:

remove в интерфейсе Collection<E>

Указано в:

remove в интерфейсе List<E>

Переопределяет:

remove в классе AbstractCollection<E>

Параметры:

o - элемент, который нужно удалить из этого Vector, если он есть

Возвращает:

true, если Vector содержал указанный элемент

С:

1.2

add

public void add(int index,
                E element)

Вставляет указанный элемент в указанную позицию в этом Vector. Смещает элемент, который в данный момент находится в этой позиции (если есть), и все последующие элементы вправо (добавляет единицу к их индексам).

Указано в:

add в интерфейсе List<E>

Переопределяет:

add в классе AbstractList<E>

Параметры:

index - индекс, в который нужно вставить указанный элемент

element - элемент, который нужно вставить

Выбрасывает:

ArrayIndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index > size())

С:

1.2

remove

public E remove(int index)

Удаляет элемент в указанной позиции в этом Vector. Смещает все последующие элементы влево (вычитает единицу из их индексов). Возвращает элемент, который был удалён из Vector.

Указано в:

remove в интерфейсе List<E>

Переопределяет:

remove в классе AbstractList<E>

Параметры:

index - индекс удаляемого элемента

Возвращает:

удаленный элемент

Выбрасывает:

ArrayIndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= size())

С:

1.2

clear

public void clear()

Удаляет все элементы из этого вектора. Вектор будет пустым после возврата этого вызова (если не будет исключения).

Указано в:

clear в интерфейсе Collection<E>

Указано в:

clear в интерфейсе List<E>

Переопределяет:

clear в классе AbstractList<E>

С:

1.2

containsAll

public boolean containsAll(Collection<?> c)

Возвращает true, если этот вектор содержит все элементы в указанном наборе.

Указано в:

containsAll в интерфейсе Collection<E>

Указано в:

containsAll в интерфейсе List<E>

Переопределяет:

containsAll в классе AbstractCollection<E>

Параметры:

c - набор, элементы которого будут проверяться на включение в этот вектор

Возвращает:

true, если этот вектор содержит все элементы в указанном наборе

Выбрасывает:

NullPointerException - если указанный набор null

См. также:

AbstractCollection.contains(Object)

addAll

public boolean addAll(Collection<? extends E> c)

Добавляет все элементы в указанном наборе в конец этого вектора в порядке, в котором они возвращаются итератором указанного набора. Поведение этой операции не определено, если указанный набор модифицируется во время выполнения операции. (Это подразумевает, что поведение этого вызова не определено, если указанный набор является этим вектором, а этот вектор не пуст.)

Указано в:

addAll в интерфейсе Collection<E>

Указано в:

addAll в интерфейсе List<E>

Переопределяет:

addAll в классе AbstractCollection<E>

Параметры:

c - элементы, которые нужно вставить в этот вектор

Возвращает:

true если этот вектор изменился в результате вызова

Выбрасывает:

NullPointerException - если указанный набор null

С:

1.2

См. также:

AbstractCollection.add(Object)

removeAll

public boolean removeAll(Collection<?> c)

Удаляет из этого вектора все его элементы, содержащиеся в указанном наборе.

Указано в:

removeAll в интерфейсе Collection<E>

Указано в:

removeAll в интерфейсе List<E>

Переопределяет:

removeAll в классе AbstractCollection<E>

Параметры:

c - набор элементов, которые нужно удалить из вектора

Возвращает:

true, если этот вектор изменился в результате вызова

Выбрасывает:

ClassCastException - если типы одного или нескольких элементов в этом векторе несовместимы с указанным набором (необязательно)

NullPointerException - если этот вектор содержит один или несколько null элементов, а указанный набор не поддерживает null элементы (необязательно), или если указанный набор null

С:

1.2

См. также:

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

retainAll

public boolean retainAll(Collection<?> c)

Сохраняет только элементы в этом векторе, которые содержатся в указанном наборе. Другими словами, удаляет из этого вектора все его элементы, которые не содержатся в указанном наборе.

Указано в:

retainAll в интерфейсе Collection<E>

Указано в:

retainAll в интерфейсе List<E>

Переопределяет:

retainAll в классе AbstractCollection<E>

Параметры:

c - набор элементов, которые нужно сохранить в этом векторе (все остальные элементы удаляются)

Возвращает:

true, если этот вектор изменился в результате вызова

Выбрасывает:

ClassCastException - если типы одного или нескольких элементов в этом векторе несовместимы с указанным набором (необязательно)

NullPointerException - если этот вектор содержит один или несколько null элементов, а указанный набор не поддерживает null элементы (необязательно), или если указанный набор null

С:

1.2

См. также:

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

addAll

public boolean addAll(int index,
                      Collection<? extends E> c)

Вставляет все элементы из указанного набора в этот вектор в указанную позицию. Сдвигает элемент, который в настоящее время находится на этой позиции (если есть), и все последующие элементы вправо (увеличивает их индексы). Новые элементы будут отображаться в векторе в том порядке, в котором они возвращаются итератором указанного набора.

Указано в:

addAll в интерфейсе List<E>

Переопределяет:

addAll в классе AbstractList<E>

Параметры:

index - индекс, в котором нужно вставить первый элемент из указанного набора

c - элементы, которые нужно вставить в этот вектор

Возвращает:

true если этот вектор изменился в результате вызова

Выбрасывает:

ArrayIndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index > size())

NullPointerException - если указанный набор null

С:

1.2

equals

public boolean equals(Object o)

Сравнивает указанный объект с этим вектором на равенство. Возвращает true тогда и только тогда, когда указанный объект также является списком, оба списка имеют одинаковый размер, и все соответствующие пары элементов в двух списках равны. (Два элемента e1 и e2 равны, если (e1==null ? e2==null : e1.equals(e2))). Другими словами, два списка определяются как равные, если они содержат одинаковые элементы в том же порядке.

Указано в:

equals в интерфейсе Collection<E>

Указано в:

equals в интерфейсе List<E>

Переопределяет:

equals в классе AbstractList<E>

Параметры:

o - объект, который нужно сравнить на равенство с этим вектором

Возвращает:

true, если указанный объект равен этому вектору

См. также:

Object.hashCode(), HashMap

hashCode

public int hashCode()

Возвращает значение кода хеширования для этого вектора.

Указано в:

hashCode в интерфейсе Collection<E>

Указано в:

hashCode в интерфейсе List<E>

Переопределяет:

hashCode в классе AbstractList<E>

Возвращает:

значение кода хеширования для этого списка

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Возвращает строковое представление этого вектора, содержащее строковое представление каждого элемента.

Переопределяет:

toString в классе AbstractCollection<E>

Возвращает:

строковое представление этой коллекции

subList

public List<E> subList(int fromIndex,
                       int toIndex)

list.subList(from, to).clear();

Указано в:

subList в интерфейсе List<E>

Переопределяет:

subList в классе AbstractList<E>

Параметры:

fromIndex - нижняя граница (включительно) подсписка

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)

Определено в:

listIterator в интерфейсе List<E>

Переопределяет:

listIterator в классе AbstractList<E>

Параметры:

index - индекс первого элемента, который должен быть возвращён итератором списка (при вызове next)

Возвращает:

итератор списка над элементами в этом списке (в правильной последовательности), начиная с указанной позиции в списке

Исключения:

IndexOutOfBoundsException - если индекс находится вне допустимого диапазона (index < 0 || index > size())

listIterator

public ListIterator<E> listIterator()

Определено в:

listIterator в интерфейсе List<E>

Переопределяет:

listIterator в классе AbstractList<E>

Возвращает:

итератор списка над элементами в этом списке (в правильной последовательности)

См. также:

listIterator(int)

iterator

public Iterator<E> iterator()

Определено в:

iterator в интерфейсе Iterable<E>

Определено в:

iterator в интерфейсе Collection<E>

Определено в:

iterator в интерфейсе List<E>

Переопределяет:

iterator в классе AbstractList<E>

Возвращает:

итератор над элементами в этом списке в правильной последовательности

forEach

public void forEach(Consumer<? super E> action)

Описание скопировано из интерфейса: Iterable

Выполняет заданное действие для каждого элемента Iterable до тех пор, пока все элементы не будут обработаны или действие не выбросит исключение. Если не указано иначе реализующим классом, действия выполняются в порядке итерации (если порядок итерации указан). Исключение, выброшенное действием, передаётся вызывающей стороне.

Определено в:

forEach в интерфейсе Iterable<E>

Параметры:

action - действие, которое должно быть выполнено для каждого элемента

removeIf

public boolean removeIf(Predicate<? super E> filter)

Описание скопировано из интерфейса: Collection

Удаляет все элементы этого набора, удовлетворяющие заданному предикату. Ошибки или исключения времени выполнения, возникающие во время итерации или предикатом, передаются вызывающей стороне.

Определено в:

removeIf в интерфейсе Collection<E>

Параметры:

filter - предикат, возвращающий true для элементов, которые должны быть удалены

Возвращает:

true если какие-либо элементы были удалены

replaceAll

public void replaceAll(UnaryOperator<E> operator)

Описание скопировано из интерфейса: List

Заменяет каждый элемент этого списка результатом применения оператора к этому элементу. Ошибки или исключения времени выполнения, выброшенные оператором, передаются вызывающей стороне.

Определено в:

replaceAll в интерфейсе List<E>

Параметры:

operator - оператор, который необходимо применить к каждому элементу

sort

public void sort(Comparator<? super E> c)

Описание скопировано из интерфейса: List

Определено в:

sort в интерфейсе List<E>

Параметры:

c - Comparator , используемый для сравнения элементов списка. Значение null указывает, что следует использовать естественный порядок элементов.

spliterator

public Spliterator<E> spliterator()

Определено в:

spliterator в интерфейсе Collection<E>

Определено в:

spliterator в интерфейсе Collection<E>

Определено в:

spliterator в интерфейсе List<E>

Возвращает:

Spliterator над элементами в этом списке

С момента:

1.8