Класс Vector<E>

Type Parameters:
E - Тип компонентных элементов
Все реализованные интерфейсы:
Serializable, Cloneable, Iterable<E>, Collection<E>, List<E>, RandomAccess
Непосредственные известные подклассы:
Stack
public class Vector<E>
extends AbstractList<E>
implements List<E>, RandomAccess, Cloneable, Serializable

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

Since:
1.0
См. также:
Collection, LinkedList, Сериализованная форма

Поля

Модификатор и тип Поле Описание
protected int capacityIncrement

Количество, на которое емкость вектора автоматически увеличивается, когда его размер становится больше его емкости.
protected int elementCount

Количество допустимых компонентов в этом объекте Vector.
protected Object[] elementData

Буфер массива, в котором хранятся компоненты вектора.

Поля, объявленные в классе java.util.AbstractList

modCount

Конструкторы

Конструктор Описание
Vector()

Создает пустой вектор, так что его внутренний массив данных имеет размер 10 и его стандартный инкремент емкости равен нулю.
Vector​(int initialCapacity)

Создает пустой вектор с указанной начальной емкостью и с инкрементом емкости, равным нулю.
Vector​(int initialCapacity, int capacityIncrement)

Создает пустой вектор с указанной начальной емкостью и инкрементом емкости.
Vector​(Collection<? extends E> c)

Создает вектор, содержащий элементы указанной коллекции в порядке, в котором они возвращаются итератором коллекции.

Методы

Модификатор и тип Метод Описание
void add​(int index, E element)

Вставляет указанный элемент в указанную позицию в этом Vector.
boolean add​(E e)

Добавляет указанный элемент в конец этого Vector.
boolean addAll​(int index, Collection<? extends E> c)

Вставляет все элементы из указанной Collection в этот Vector в указанную позицию.
boolean addAll​(Collection<? extends E> c)

Добавляет все элементы из указанной Collection в конец этого Vector в порядке, в котором они возвращаются итератором указанной Collection.
void addElement​(E obj)

Добавляет указанный компонент в конец этого вектора, увеличивая его размер на единицу.
int capacity()

Возвращает текущую емкость этого вектора.
void clear()

Удаляет все элементы из этого Vector.
Object clone()

Возвращает копию этого вектора.
boolean contains​(Object o)

Возвращает true, если этот вектор содержит указанный элемент.
boolean containsAll​(Collection<?> c)

Возвращает true, если этот Vector содержит все элементы из указанной Collection.
void copyInto​(Object[] anArray)

Копирует компоненты этого вектора в указанный массив.
E elementAt​(int index)

Возвращает компонент в указанном индексе.
Enumeration<E> elements()

Возвращает перечисление компонентов этого вектора.
void ensureCapacity​(int minCapacity)

Увеличивает емкость этого вектора, если необходимо, чтобы обеспечить возможность хранения по крайней мере количества компонентов, указанного аргументом минимальной емкости.
boolean equals​(Object o)

Сравнивает указанный объект с этим Vector на равенство.
E firstElement()

Возвращает первый компонент (элемент с индексом 0) этого вектора.
void forEach​(Consumer<? super E> action)

Выполняет заданное действие для каждого элемента Iterable до тех пор, пока все элементы не будут обработаны или действие не выбросит исключение.
E get​(int index)

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

Возвращает значение хэш-кода для этого Vector.
int indexOf​(Object o)

Возвращает индекс первого вхождения указанного элемента в этом векторе или -1, если этот вектор не содержит элемент.
int indexOf​(Object o, int index)

Возвращает индекс первого вхождения указанного элемента в этом векторе, выполняя поиск вперед с index, или возвращает -1, если элемент не найден.
void insertElementAt​(E obj, int index)

Вставляет указанный объект в качестве компонента в этот вектор в указанную index.
boolean isEmpty()

Проверяет, пуст ли этот вектор.
Iterator<E> iterator()

Возвращает итератор по элементам в этом списке в правильном порядке.
E lastElement()

Возвращает последний компонент вектора.
int lastIndexOf​(Object o)

Возвращает индекс последнего вхождения указанного элемента в этом векторе, или -1, если этот вектор не содержит элемент.
int lastIndexOf​(Object o, int index)

Возвращает индекс последнего вхождения указанного элемента в этом векторе, выполняя поиск назад с index, или возвращает -1, если элемент не найден.
ListIterator<E> listIterator()

Возвращает итератор по элементам в этом списке (в правильном порядке).
ListIterator<E> listIterator​(int index)

Возвращает итератор по элементам в этом списке (в правильном порядке), начиная с указанной позиции в списке.
E remove​(int index)

Удаляет элемент в указанной позиции в этом Vector.
boolean remove​(Object o)

Удаляет первое вхождение указанного элемента в этот Vector. Если Vector не содержит элемент, то он остается без изменений.
boolean removeAll​(Collection<?> c)

Удаляет из этого Vector все его элементы, которые содержатся в указанной Collection.
void removeAllElements()

Удаляет все компоненты из этого вектора и устанавливает его размер в ноль.
boolean removeElement​(Object obj)

Удаляет первое (с самым низким индексом) вхождение аргумента из этого вектора.
void removeElementAt​(int index)

Удаляет компонент по указанному индексу.
boolean removeIf​(Predicate<? super E> filter)

Удаляет все элементы этого набора, удовлетворяющие заданному предикату.
protected void removeRange​(int fromIndex, int toIndex)

Удаляет из этого списка все элементы, чей индекс находится между fromIndex, включительно, и toIndex, исключая.
void replaceAll​(UnaryOperator<E> operator)

Заменяет каждый элемент этого списка результатом применения оператора к этому элементу.
boolean retainAll​(Collection<?> c)

Оставляет только элементы в этом Vector, которые содержатся в указанной Collection.
E set​(int index, E element)

Заменяет элемент в указанной позиции в этом Vector указанным элементом.
void setElementAt​(E obj, int index)

Устанавливает компонент в указанной index этого вектора в качестве указанного объекта.
void setSize​(int newSize)

Устанавливает размер этого вектора.
int size()

Возвращает количество компонентов в этом векторе.
Spliterator<E> spliterator()

Создает отложенную привязку и быстродействующий Spliterator над элементами в этом списке.
List<E> subList​(int fromIndex, int toIndex)

Возвращает представление части этого List между fromIndex, включительно, и toIndex, исключая.
Object[] toArray()

Возвращает массив, содержащий все элементы в этом Vector в правильном порядке.
<T> T[] toArray​(T[] a)

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

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

Уменьшает емкость этого вектора до его текущего размера.

Методы, объявленные в классе java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе java.util.Collection

parallelStream, stream, toArray

Методы, объявленные в интерфейсе java.util.List

sort

Поля

elementData

protected Object[] elementData

Буфер массива, в котором хранятся компоненты вектора. Ёмкость вектора равна длине этого буфера массива и, по крайней мере, достаточно велика, чтобы содержать все элементы вектора.

Любые элементы массива, следующие за последним элементом в векторе, равны null.

elementCount

protected int elementCount

Число допустимых компонентов в этом объекте. Компоненты Vector по elementData[0] являются фактическими элементами.

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, то его емкость увеличивается путем замены его внутреннего массива данных, хранящегося в поле elementData, на больший. Размер нового массива данных будет равен старому размеру плюс capacityIncrement, если значение capacityIncrement не меньше или равно нулю, в противном случае новая емкость будет в два раза больше старой емкости; но если этот новый размер все еще меньше minCapacity, то новая емкость будет 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>
Возвращает:
количество компонентов в этом векторе

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

Указано в:
contains в интерфейсе Collection<E>
Указано в:
contains в интерфейсе List<E>
Переопределяет:
contains в классе AbstractCollection<E>
Параметры:
o - элемент, наличие которого в этом векторе необходимо проверить
Возвращает:
true если этот вектор содержит указанный элемент

indexOf

public int indexOf(Object o)

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

Указано в:
indexOf в интерфейсе List<E>
Переопределяет:
indexOf в классе AbstractList<E>
Параметры:
o - элемент для поиска
Возвращает:
индекс первого вхождения указанного элемента в этот вектор или -1, если этот вектор не содержит элемент

indexOf

public int indexOf(Object o,
                   int index)

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

Параметры:
o - элемент для поиска
index - индекс, с которого начать поиск
Возвращает:
индекс первого вхождения элемента в этом векторе в позиции index или позже в векторе; -1, если элемент не найден.
Исключения:
IndexOutOfBoundsException - если указанный индекс отрицателен
См. также:
Object.equals(Object)

lastIndexOf

public int lastIndexOf(Object o)

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

Указано в:
lastIndexOf в интерфейсе List<E>
Переопределяет:
lastIndexOf в классе AbstractList<E>
Параметры:
o - элемент для поиска
Возвращает:
индекс последнего вхождения указанного элемента в этот вектор или -1, если этот вектор не содержит элемент

lastIndexOf

public int lastIndexOf(Object o,
                       int index)

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

Параметры:
o - элемент для поиска
index - индекс, с которого начать обратный поиск
Возвращает:
индекс последнего вхождения элемента в позиции меньше или равной index в этом векторе; -1, если элемент не найден.
Исключения:
IndexOutOfBoundsException - если указанный индекс больше или равен текущему размеру этого вектора

elementAt

public E elementAt(int index)

Возвращает компонент с указанным индексом.

Этот метод идентичен по функциональности методу get(int) (который является частью интерфейса List).

Параметры:
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)

Устанавливает компонент с указанным index этого вектора как указанный объект. Предыдущий компонент в этой позиции отбрасывается.

Индекс должен быть значением больше или равным 0 и меньше текущего размера вектора.

Этот метод идентичен по функциональности методу set(int, E) (который является частью интерфейса List). Обратите внимание, что метод set меняет порядок параметров, чтобы больше соответствовать использованию массивов. Обратите также внимание, что метод set возвращает старое значение, которое было сохранено в указанной позиции.

Параметры:
obj - на что должен быть установлен компонент
index - указанный индекс
Исключения:
ArrayIndexOutOfBoundsException - если индекс выходит за пределы диапазона (index < 0 || index >= size())

removeElementAt

public void removeElementAt(int index)

Удаляет компонент по указанному индексу. Каждый компонент в этом векторе с индексом, равным или большим указанного index, сдвигается вниз, чтобы иметь индекс на единицу меньше, чем предыдущее значение. Размер этого вектора уменьшается на 1.

Индекс должен быть значением, большим или равным 0 и меньшим текущего размера вектора.

Этот метод идентичен по функциональности методу remove(int) (который является частью интерфейса List). Обратите внимание, что метод remove возвращает старое значение, которое хранилось в указанной позиции.

Parameters:
index - индекс объекта для удаления
Throws:
ArrayIndexOutOfBoundsException - если индекс выходит за пределы диапазона (index < 0 || index >= size())

insertElementAt

public void insertElementAt(E obj,
                            int index)

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

Индекс должен быть значением, большим или равным 0 и меньше или равно текущему размеру вектора. (Если индекс равен текущему размеру вектора, новый элемент добавляется в вектор.)

Этот метод идентичен по функциональности методу add(int, E) (который является частью интерфейса List). Обратите внимание, что метод add изменяет порядок параметров, чтобы более точно соответствовать использованию массивов.

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

addElement

public void addElement(E obj)

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

Этот метод идентичен по функциональности методу add(E) (который является частью интерфейса List).

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

removeElement

public boolean removeElement(Object obj)

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

Этот метод идентичен по функциональности методу remove(Object) (который является частью интерфейса List).

Parameters:
obj - компонент для удаления
Returns:
true если аргумент был компонентом этого вектора; false в противном случае.

removeAllElements

public void removeAllElements()

Удаляет все компоненты из этого вектора и устанавливает его размер в ноль.

Этот метод идентичен по функциональности методу clear() (который является частью интерфейса List).

clone

public Object clone()

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

Overrides:
clone в классе Object
Returns:
копия этого вектора
See Also:
Cloneable

toArray

public Object[] toArray()

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

Specified by:
toArray в интерфейсе Collection<E>
Specified by:
toArray в интерфейсе List<E>
Overrides:
toArray в классе AbstractCollection<E>
Returns:
массив, чье тип компонента времени выполнения является Object, содержащий все элементы этого набора
Since:
1.2
See Also:
Arrays.asList(Object[])

toArray

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

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

Если Vector помещается в указанный массив с избытком места (т.е. массив содержит больше элементов, чем Vector), элемент в массиве сразу за концом Vector устанавливается в null. (Это полезно для определения длины Vector *только* если вызывающий метод знает, что Vector не содержит элементов null.)

Specified by:
toArray в интерфейсе Collection<E>
Specified by:
toArray в интерфейсе List<E>
Overrides:
toArray в классе AbstractCollection<E>
Type Parameters:
T - тип элементов массива. Тот же тип, что и <E> или супертип <E>.
Parameters:
a - массив, в который должны быть помещены элементы Vector, если он достаточно велик; в противном случае для этой цели выделяется новый массив того же типа времени выполнения.
Returns:
массив, содержащий элементы Vector
Throws:
ArrayStoreException - если тип времени выполнения a, <T>, не является супертипом типа времени выполнения, <E>, каждого элемента в этом Vector
NullPointerException - если заданный массив равен null
Since:
1.2

get

public E get(int index)

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

Specified by:
get в интерфейсе List<E>
Specified by:
get в классе AbstractList<E>
Parameters:
index - индекс возвращаемого элемента
Returns:
объект в указанном индексе
Throws:
ArrayIndexOutOfBoundsException - если индекс выходит за пределы диапазона (index < 0 || index >= size())
Since:
1.2

set

public E set(int index,
             E element)

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

Specified by:
set в интерфейсе List<E>
Overrides:
set в классе AbstractList<E>
Parameters:
index - индекс заменяемого элемента
element - элемент, который нужно сохранить в указанной позиции
Returns:
элемент, который ранее находился в указанной позиции
Throws:
ArrayIndexOutOfBoundsException - если индекс выходит за пределы диапазона (index < 0 || index >= size())
Since:
1.2

add

public boolean add(E e)

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

Specified by:
add в интерфейсе Collection<E>
Specified by:
add в интерфейсе List<E>
Overrides:
add в классе AbstractList<E>
Parameters:
e - элемент, который нужно добавить в этот Vector
Returns:
true (как указано в Collection.add(E))
Since:
1.2

remove

public boolean remove(Object o)

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

Specified by:
remove в интерфейсе Collection<E>
Specified by:
remove в интерфейсе List<E>
Overrides:
remove в классе AbstractCollection<E>
Parameters:
o - элемент, который нужно удалить из этого Vector, если он присутствует
Returns:
true, если Vector содержал указанный элемент
Since:
1.2

add

public void add(int index,
                E element)

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

Specified by:
add в интерфейсе List<E>
Overrides:
add в классе AbstractList<E>
Parameters:
index - индекс, в который должен быть вставлен указанный элемент
element - вставляемый элемент
Throws:
ArrayIndexOutOfBoundsException - если индекс выходит за пределы диапазона (index < 0 || index > size())
Since:
1.2

remove

public E remove(int index)

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

Specified by:
remove в интерфейсе List<E>
Overrides:
remove в классе AbstractList<E>
Parameters:
index - индекс удаляемого элемента
Returns:
удаленный элемент
Throws:
ArrayIndexOutOfBoundsException - если индекс выходит за пределы диапазона (index < 0 || index >= size())
Since:
1.2

clear

public void clear()

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

Указано:
clear в интерфейсе Collection<E>
Указано:
clear в интерфейсе List<E>
Переопределено:
clear в классе AbstractList<E>
С:
1.2

containsAll

public boolean containsAll(Collection<?> c)

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

Указано:
containsAll в интерфейсе Collection<E>
Указано:
containsAll в интерфейсе List<E>
Переопределено:
containsAll в классе AbstractCollection<E>
Параметры:
c - коллекция, элементы которой будут проверены на содержание в этом Vector
Возвращает:
true, если этот Vector содержит все элементы в указанной коллекции
Исключения:
NullPointerException - если указанная коллекция равна null
См. также:
AbstractCollection.contains(Object)

addAll

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

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

Указано:
addAll в интерфейсе Collection<E>
Указано:
addAll в интерфейсе List<E>
Переопределено:
addAll в классе AbstractCollection<E>
Параметры:
c - элементы, которые будут вставлены в этот Vector
Возвращает:
true если этот Vector изменился в результате вызова
Исключения:
NullPointerException - если указанная коллекция равна null
С:
1.2
См. также:
AbstractCollection.add(Object)

removeAll

public boolean removeAll(Collection<?> c)

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

Указано:
removeAll в интерфейсе Collection<E>
Указано:
removeAll в интерфейсе List<E>
Переопределено:
removeAll в классе AbstractCollection<E>
Параметры:
c - коллекция элементов, которые нужно удалить из Vector
Возвращает:
true, если этот Vector изменился в результате вызова
Исключения:
ClassCastException - если типы одного или нескольких элементов в этом векторе несовместимы с указанной коллекцией (необязательно)
NullPointerException - если этот вектор содержит один или несколько нулевых элементов, а указанная коллекция не поддерживает нулевые элементы (необязательно), или если указанная коллекция равна null
С:
1.2
См. также:
AbstractCollection.remove(Object), AbstractCollection.contains(Object)

retainAll

public boolean retainAll(Collection<?> c)

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

Указано:
retainAll в интерфейсе Collection<E>
Указано:
retainAll в интерфейсе List<E>
Переопределено:
retainAll в классе AbstractCollection<E>
Параметры:
c - коллекция элементов, которые должны быть сохранены в этом Vector (все остальные элементы удаляются)
Возвращает:
true, если этот Vector изменился в результате вызова
Исключения:
ClassCastException - если типы одного или нескольких элементов в этом векторе несовместимы с указанной коллекцией (необязательно)
NullPointerException - если этот вектор содержит один или несколько нулевых элементов, а указанная коллекция не поддерживает нулевые элементы (необязательно), или если указанная коллекция равна null
С:
1.2
См. также:
AbstractCollection.remove(Object), AbstractCollection.contains(Object)

removeIf

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

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

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

Указано:
removeIf в интерфейсе Collection<E>
Параметры:
filter - предикат, который возвращает true для элементов, которые нужно удалить
Возвращает:
true если были удалены какие-либо элементы
Исключения:
NullPointerException - если указанный фильтр равен null

addAll

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

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

Указано:
addAll в интерфейсе List<E>
Переопределено:
addAll в классе AbstractList<E>
Параметры:
index - индекс, в котором нужно вставить первый элемент из указанной коллекции
c - элементы, которые нужно вставить в этот Vector
Возвращает:
true если этот Vector изменился в результате вызова
Исключения:
ArrayIndexOutOfBoundsException - если индекс находится вне диапазона (index < 0 || index > size())
NullPointerException - если указанная коллекция равна null
С:
1.2

equals

public boolean equals(Object o)

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

Указано:
equals в интерфейсе Collection<E>
Указано:
equals в интерфейсе List<E>
Переопределено:
equals в классе AbstractList<E>
Параметры:
o - Object, который нужно сравнить на равенство с этим Vector
Возвращает:
true, если указанный Object равен этому Vector
См. также:
Object.hashCode(), HashMap

hashCode

public int hashCode()

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

Указано:
hashCode в интерфейсе Collection<E>
Указано:
hashCode в интерфейсе List<E>
Переопределено:
hashCode в классе AbstractList<E>
Возвращает:
значение хэш-кода для этого списка
См. также:
Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

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

Переопределено:
toString в классе AbstractCollection<E>
Возвращает:
строковое представление этого набора

subList

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

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

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

list.subList(from, to).clear();
Аналогичные фрагменты кода могут быть построены для indexOf и lastIndexOf, и все алгоритмы в классе Collections могут быть применены к subList.

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

Указано:
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, данная операция не имеет эффекта.)

Overrides:
removeRange в классе AbstractList<E>
Parameters:
fromIndex - индекс первого элемента, который будет удален
toIndex - индекс после последнего элемента, который будет удален

listIterator

public ListIterator<E> listIterator(int index)

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

Возвращаемый итератор списка является быстродействующим.

Specified by:
listIterator в интерфейсе List<E>
Overrides:
listIterator в классе AbstractList<E>
Parameters:
index - индекс первого элемента, который будет возвращен итератором списка (вызовом next)
Returns:
итератор списка над элементами в этом списке (в правильной последовательности), начиная с указанной позиции в списке
Throws:
IndexOutOfBoundsException - если индекс находится вне допустимого диапазона (index < 0 || index > size())

listIterator

public ListIterator<E> listIterator()

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

Возвращаемый итератор списка является быстродействующим.

Specified by:
listIterator в интерфейсе List<E>
Overrides:
listIterator в классе AbstractList<E>
Returns:
итератор списка над элементами в этом списке (в правильной последовательности)
See Also:
listIterator(int)

iterator

public Iterator<E> iterator()

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

Возвращаемый итератор является быстродействующим.

Specified by:
iterator в интерфейсе Collection<E>
Specified by:
iterator в интерфейсе Iterable<E>
Specified by:
iterator в интерфейсе List<E>
Overrides:
iterator в классе AbstractList<E>
Returns:
итератор по элементам в этом списке в правильной последовательности

forEach

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

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

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

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

Specified by:
forEach в интерфейсе Iterable<E>
Parameters:
action - действие, которое должно быть выполнено для каждого элемента
Throws:
NullPointerException - если указанное действие равно null

replaceAll

public void replaceAll(UnaryOperator<E> operator)

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

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

Specified by:
replaceAll в интерфейсе List<E>
Parameters:
operator - оператор, который следует применить к каждому элементу
Throws:
NullPointerException - если указанный оператор равен null или результат оператора равен null, и этот список не допускает null-элементов (необязательно)

spliterator

public Spliterator<E> spliterator()

Создаёт отложенную привязку и быстродействующую Spliterator над элементами в этом списке.

Этот Spliterator сообщает о Spliterator.SIZED, Spliterator.SUBSIZED и Spliterator.ORDERED. Переопределяющие реализации должны документировать сообщение об дополнительных характеристиках.

Specified by:
spliterator в интерфейсе Collection<E>
Specified by:
spliterator в интерфейсе Iterable<E>
Specified by:
spliterator в интерфейсе Collection<E>
Returns:
Spliterator над элементами в этом списке
Since:
1.8

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Vector.html

Spec-Zone .ru
спецификации, руководства, описания, API