Класс Vector<E>

elementData

protected Object[] elementData

elementCount

protected int elementCount

capacityIncrement

protected int capacityIncrement

Vector

public Vector(int initialCapacity, int capacityIncrement)

Параметры:

initialCapacity - начальная вместимость вектора

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

Исключения:

IllegalArgumentException - если указанная начальная вместимость отрицательна

Vector

public Vector(int initialCapacity)

Параметры:

initialCapacity - начальная вместимость вектора

Исключения:

IllegalArgumentException - если указанная начальная вместимость отрицательна

Vector

public Vector()

Vector

public Vector(Collection<? extends E> c)

Параметры:

c - коллекция, элементы которой должны быть помещены в этот вектор

Исключения:

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

С версии:

1.2

copyInto

public void copyInto(Object[] anArray)

Параметры:

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

Исключения:

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

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

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

См. также:

• toArray(Object[])

trimToSize

public void trimToSize()

ensureCapacity

public void ensureCapacity(int minCapacity)

Параметры:

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

setSize

public void setSize(int newSize)

Параметры:

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

Исключения:

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

capacity

public int capacity()

Возвращает:

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

size

public int size()

Указано в:

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

Указано в:

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

Возвращает:

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

isEmpty

public boolean isEmpty()

Указано в:

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

Указано в:

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

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

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

Возвращает:

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

elements

public Enumeration<E> elements()

Возвращает:

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

См. также:

• Iterator

contains

public boolean contains(Object o)

Указано в:

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

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

indexOf

public int indexOf(Object o)

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

indexOf

public int indexOf(Object o, int index)

Параметры:

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

index - индекс, с которого нужно начать поиск

Возвращает:

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

Исключения:

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

См. также:

• Object.equals(Object)

lastIndexOf

public int lastIndexOf(Object o)

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

lastIndexOf

public int lastIndexOf(Object o, int index)

Параметры:

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

index - индекс, с которого следует начать поиск в обратном направлении

Возвращает:

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

Исключения:

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

elementAt

public E elementAt(int index)

Параметры:

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

Возвращает:

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

Исключения:

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

firstElement

public E firstElement()

Возвращает:

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

Исключения:

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()

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

clone в классе Object

Возвращает:

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

См. также:

• Cloneable

toArray

public Object[] toArray()

Указано в:

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

Указано в:

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

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

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

Возвращает:

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

С версии:

1.2

См. также:

• Arrays.asList(Object[])

toArray

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

get

public E get(int index)

Указано в:

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

Указано в:

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

Параметры:

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

Возвращает:

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

Исключения:

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

С версии:

1.2

set

public E set(int index, E element)

Указано в:

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

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

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

С версии:

1.2

add

public boolean add(E e)

Указано в:

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

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

С версии:

1.2

remove

public boolean remove(Object o)

Указано в:

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

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

С версии:

1.2

add

public void add(int index, E element)

Указано в:

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

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

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

Параметры:

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

element - элемент для вставки

Исключения:

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

С версии:

1.2

remove

public E remove(int index)

Указано в:

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)

Указано в:

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)

Specified by:

retainAll in interface Collection<E>

Specified by:

retainAll in interface List<E>

Overrides:

retainAll in class AbstractCollection<E>

Parameters:

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

Returns:

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

Throws:

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

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

Since:

1.2

See Also:

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

removeIf

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

Specified by:

removeIf in interface Collection<E>

Parameters:

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

Returns:

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

Throws:

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

addAll

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

Returns:

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

Throws:

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

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

Since:

1.2

equals

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 - объект, который необходимо сравнить на равенство с этим вектором

Returns:

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

See Also:

• Object.hashCode()
• HashMap

hashCode

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.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)

toString

public String toString()

Overrides:

toString in class AbstractCollection<E>

Returns:

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

subList

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)

removeRange

protected void removeRange(int fromIndex, int toIndex)

Overrides:

removeRange in class AbstractList<E>

Parameters:

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

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

listIterator

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())

listIterator

public ListIterator<E> listIterator()

Specified by:

listIterator in interface List<E>

Overrides:

listIterator in class AbstractList<E>

Returns:

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

See Also:

• listIterator(int)

iterator

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:

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

forEach

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

Указано в:

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

Параметры:

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

Исключения:

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

replaceAll

public void replaceAll(UnaryOperator<E> operator)

Указано в:

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

Параметры:

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

Исключения:

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

spliterator

public Spliterator<E> spliterator()

Указано в:

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

Указано в:

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

Указано в:

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

Возвращает:

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

С версии:

1.8