Класс 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 — массив, в который следует поместить элементы Vector, если его размер достаточен; в противном случае для этой цели выделяется новый массив того же типа во время выполнения.

Возвращает:

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

Исключения:

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

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 — элемент, добавляемый в конец этого Vector

Возвращает:

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

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

1.2

public boolean remove(Object o)

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

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

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 — если типы одного или нескольких элементов этого вектора несовместимы с указанной коллекцией (необязательно)

NullPointerException — если этот вектор содержит один или несколько элементов 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 — если типы одного или нескольких элементов этого вектора несовместимы с указанной коллекцией (необязательно)

NullPointerException — если этот вектор содержит один или несколько элементов 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 — объект, который нужно сравнить на равенство с этим Vector

Возвращает:

true, если указанный объект равен этому 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 — нижняя граница (включительно) подсписка

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

Возвращает:

представление указанного диапазона в этом 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