Класс Vector<E>

protected Object[] elementData

protected int elementCount

protected int capacityIncrement

public Vector(int initialCapacity, int capacityIncrement)

Параметры:

initialCapacity — начальная ёмкость вектора

capacityIncrement — величина, на которую увеличивается ёмкость при переполнении вектора

Исключения:

IllegalArgumentException — если задана отрицательная начальная ёмкость

public Vector(int initialCapacity)

Параметры:

initialCapacity — начальная ёмкость вектора

Исключения:

IllegalArgumentException — если задана отрицательная начальная ёмкость

public Vector()

public Vector(Collection<? extends E> c)

Параметры:

c — коллекция, элементы которой нужно поместить в этот вектор

Исключения:

NullPointerException — если заданная коллекция равна null

Начиная с версии:

1.2

public void copyInto(Object[] anArray)

Параметры:

anArray — массив, в который копируются компоненты

Исключения:

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

IndexOutOfBoundsException — если заданный массив недостаточно велик для хранения всех компонентов этого вектора

ArrayStoreException — если тип компонента этого вектора во время выполнения несовместим с типом, допускающим хранение в заданном массиве

См. также:

• toArray(Object[])

public void trimToSize()

public void ensureCapacity(int minCapacity)

Параметры:

minCapacity — требуемая минимальная ёмкость

public void setSize(int newSize)

Параметры:

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

Исключения:

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

public int capacity()

Возвращает:

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

public int size()

Определён в:

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

Определён в:

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

Возвращает:

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

public boolean isEmpty()

Определён в:

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

Определён в:

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

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

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

Возвращает:

true тогда и только тогда, когда этот вектор не содержит компонентов, то есть его размер равен нулю; в противном случае — false.

public Enumeration<E> elements()

Возвращает:

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

См. также:

• Iterator

public boolean contains(Object o)

Определён в:

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

Определён в:

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

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

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

Параметры:

o — элемент, наличие которого в этом векторе нужно проверить

Возвращает:

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

public int indexOf(Object o)

Определён в:

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

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

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

Параметры:

o — элемент для поиска

Возвращает:

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

public int indexOf(Object o, int index)

Параметры:

o — элемент для поиска

index — индекс, с которого начинается поиск

Возвращает:

индекс первого вхождения элемента в этом векторе в позиции index или позже; -1, если элемент не найден.

Исключения:

IndexOutOfBoundsException — если заданный индекс отрицателен

См. также:

• Object.equals(Object)

public int lastIndexOf(Object o)

Определён в:

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

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

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

Параметры:

o — элемент для поиска

Возвращает:

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

public int lastIndexOf(Object o, int index)

Параметры:

o — элемент для поиска

index — индекс, с которого начинается поиск в обратном направлении

Возвращает:

индекс последнего вхождения элемента в позиции, меньшей или равной index в этом векторе; -1, если элемент не найден.

Исключения:

IndexOutOfBoundsException — если заданный индекс больше или равен текущему размеру этого вектора

public E elementAt(int index)

Параметры:

index — индекс в этом векторе

Возвращает:

компонент с заданным индексом

Исключения:

ArrayIndexOutOfBoundsException — если индекс выходит за пределы допустимого диапазона (index < 0 || index >= size())

public E firstElement()

Возвращает:

первый компонент этого вектора

Исключения:

NoSuchElementException — если этот вектор не содержит компонентов

public E lastElement()

Возвращает:

последний компонент вектора, то есть компонент с индексом size() - 1

Исключения:

NoSuchElementException — если этот вектор пуст

public void setElementAt(E obj, int index)

Параметры:

obj — значение, которое будет установлено в качестве компонента

index — заданный индекс

Исключения:

ArrayIndexOutOfBoundsException — если индекс выходит за пределы допустимого диапазона (index < 0 || index >= size())

public void removeElementAt(int index)

Параметры:

index — индекс удаляемого объекта

Исключения:

ArrayIndexOutOfBoundsException — если индекс выходит за пределы допустимого диапазона (index < 0 || index >= size())

public void insertElementAt(E obj, int index)

Параметры:

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

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

Исключения:

ArrayIndexOutOfBoundsException — если индекс выходит за пределы допустимого диапазона (index < 0 || index > size())

public void addElement(E obj)

Параметры:

obj — добавляемый компонент

public boolean removeElement(Object obj)

Параметры:

obj — удаляемый компонент

Возвращает:

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

public void removeAllElements()

public Object clone()

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

clone в классе Object

Возвращает:

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

См. также:

• Cloneable

public Object[] toArray()

Определён в:

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

Определён в:

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

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

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

Возвращает:

массив, чей тип компонентов во время выполнения равен Object и который содержит все элементы этой коллекции

Начиная с версии:

1.2

См. также:

• Arrays.asList(Object[])

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

Определён в:

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

Определён в:

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

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

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

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

T — тип элементов массива. Тот же тип, что и <E>, либо супертип <E>.

Параметры:

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

Возвращает:

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

Исключения:

ArrayStoreException — если тип массива a во время выполнения, <T>, не является супертипом типа во время выполнения, <E>, каждого элемента этого вектора

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

Начиная с версии:

1.2

public E get(int index)

Определён в:

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

Определён в:

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

Параметры:

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

Возвращает:

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

Исключения:

ArrayIndexOutOfBoundsException — если индекс выходит за пределы допустимого диапазона (index < 0 || index >= size())

Начиная с версии:

1.2

public E set(int index, E element)

Определён в:

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

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

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

Параметры:

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

element — элемент, который будет сохранён в заданной позиции

Возвращает:

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

Исключения:

ArrayIndexOutOfBoundsException — если индекс выходит за пределы допустимого диапазона (index < 0 || index >= size())

Начиная с версии:

1.2

public boolean add(E e)

Определён в:

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

Определён в:

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

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

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

Параметры:

e — элемент, добавляемый в конец этого вектора

Возвращает:

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

Начиная с версии:

1.2

public boolean remove(Object o)

Определён в:

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

Определён в:

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

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

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

Параметры:

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

Возвращает:

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

Начиная с версии:

1.2

public void add(int index, E element)

Определён в:

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

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

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

Параметры:

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

element — вставляемый элемент

Исключения:

ArrayIndexOutOfBoundsException — если индекс выходит за пределы допустимого диапазона (index < 0 || index > size())

Начиная с версии:

1.2

public E remove(int index)

Определён в:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

ArrayIndexOutOfBoundsException — если индекс выходит за пределы допустимого диапазона (index < 0 || index >= size())

Начиная с версии:

1.2

public void clear()

Определён в:

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

Определён в:

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

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

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

Начиная с версии:

1.2

public boolean containsAll(Collection<?> c)

Указано в:

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

Указано в:

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

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

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

Параметры:

c - коллекция, элементы которой будут проверены на наличие в этом Vector

Возвращает:

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

Исключения:

NullPointerException - если указанная коллекция равна null

См. также:

• AbstractCollection.contains(Object)

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

Указано в:

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

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

NullPointerException - если указанная коллекция равна null

Начиная с:

1.2

См. также:

• AbstractCollection.add(Object)

public boolean removeAll(Collection<?> c)

Указано в:

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

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

Начиная с:

1.2

См. также:

• AbstractCollection.remove(Object)
• AbstractCollection.contains(Object)

public boolean retainAll(Collection<?> c)

Указано в:

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

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

Начиная с:

1.2

См. также:

• AbstractCollection.remove(Object)
• AbstractCollection.contains(Object)

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

Указано в:

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

Параметры:

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

Возвращает:

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

Исключения:

NullPointerException - если указанный фильтр равен null

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

Указано в:

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

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

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

NullPointerException - если указанная коллекция равна null

Начиная с:

1.2

public boolean equals(Object o)

Указано в:

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

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

См. также:

• Object.equals(Object)
• Set.equals(Object)
• List.equals(Object)

public int hashCode()

Указано в:

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

Указано в:

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

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

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

Возвращает:

значение хеш-кода этого списка

См. также:

• Object.hashCode()
• Object.equals(Object)

public String toString()

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

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

Возвращает:

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

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

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

Указано в:

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

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

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

Параметры:

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

toIndex - верхняя граница (исключительно) subList

Возвращает:

представление указанного диапазона в этом List

Исключения:

IndexOutOfBoundsException - если значение индекса одной из границ выходит за допустимый диапазон (fromIndex < 0 || toIndex > size)

IllegalArgumentException - если индексы границ указаны в неправильном порядке (fromIndex > toIndex)

protected void removeRange(int fromIndex, int toIndex)

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

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

Параметры:

fromIndex - индекс первого удаляемого элемента

toIndex - индекс, следующий за последним удаляемым элементом

public ListIterator<E> listIterator(int index)

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

public ListIterator<E> listIterator()

Указано в:

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

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

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

Возвращает:

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

См. также:

• listIterator(int)

public Iterator<E> iterator()

Указано в:

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

Указано в:

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

Указано в:

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

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

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

Возвращает:

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

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

Указано в:

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

Параметры:

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

Исключения:

NullPointerException - если указанное действие равно null

public void replaceAll(UnaryOperator<E> operator)

Указано в:

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

Параметры:

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

Исключения:

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

public Spliterator<E> spliterator()

Указано в:

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

Указано в:

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

Указано в:

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

Возвращает:

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

Начиная с:

1.8