Класс 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)

Specified by:

removeAll in interface Collection<E>

Specified by:

removeAll in interface List<E>

Overrides:

removeAll in class AbstractCollection<E>

Parameters:

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

Returns:

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

Throws:

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

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

Since:

1.2

See Also:

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

public boolean retainAll(Collection<?> c)

Specified by:

retainAll in interface Collection<E>

Specified by:

retainAll in interface List<E>

Overrides:

retainAll in class AbstractCollection<E>

Parameters:

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

Returns:

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

Throws:

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

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

Since:

1.2

See Also:

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

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

Specified by:

removeIf in interface Collection<E>

Parameters:

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

Returns:

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

Throws:

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

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

Specified by:

addAll in interface List<E>

Overrides:

addAll in class AbstractList<E>

Parameters:

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

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

Returns:

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

Throws:

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

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

Since:

1.2

public boolean equals(Object o)

Specified by:

equals in interface Collection<E>

Specified by:

equals in interface List<E>

Overrides:

equals in class AbstractList<E>

Parameters:

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

Returns:

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

See Also:

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

public int hashCode()

Specified by:

hashCode in interface Collection<E>

Specified by:

hashCode in interface List<E>

Overrides:

hashCode in class AbstractList<E>

Returns:

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

See Also:

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

public String toString()

Overrides:

toString in class AbstractCollection<E>

Returns:

строковое представление этого набора

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

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

Specified by:

subList in interface List<E>

Overrides:

subList in class AbstractList<E>

Parameters:

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

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

Returns:

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

Throws:

IndexOutOfBoundsException - если индекс конечной точки находится вне диапазона (fromIndex < 0 || toIndex > size)

IllegalArgumentException - если индексы конечных точек указаны в обратном порядке (fromIndex > toIndex)

protected void removeRange(int fromIndex, int toIndex)

Overrides:

removeRange in class AbstractList<E>

Parameters:

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

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

public ListIterator<E> listIterator(int index)

Specified by:

listIterator in interface List<E>

Overrides:

listIterator in class AbstractList<E>

Parameters:

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

Returns:

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

Throws:

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

public ListIterator<E> listIterator()

Specified by:

listIterator in interface List<E>

Overrides:

listIterator in class AbstractList<E>

Returns:

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

See Also:

• listIterator(int)

public Iterator<E> iterator()

Specified by:

iterator in interface Collection<E>

Specified by:

iterator in interface Iterable<E>

Specified by:

iterator in interface List<E>

Overrides:

iterator in class AbstractList<E>

Returns:

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

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

Specified by:

forEach in interface Iterable<E>

Parameters:

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

Throws:

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

public void replaceAll(UnaryOperator<E> operator)

Specified by:

replaceAll in interface List<E>

Parameters:

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

Throws:

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

public Spliterator<E> spliterator()

Specified by:

spliterator in interface Collection<E>

Specified by:

spliterator in interface Iterable<E>

Specified by:

spliterator in interface List<E>

Returns:

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

Since:

1.8