Класс Vector<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.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. Таким образом, при одновременном изменении итератор быстро и четко завершает работу, а не рискует произвольной непредсказуемой работой в неопределенное время в будущем. Возвращаемые методом elements объекты Enumerations не являются быстропроверяемыми; если вектор структурно изменяется в любой момент после создания перечисления, результаты перечисления не определены.

Обратите внимание, что поведение быстропроверяемого итератора не может быть гарантировано, так как, как правило, невозможно дать какие-либо строгие гарантии при одновременном изменении без синхронизации. Итераторы быстропроверяемого типа генерируют исключения ConcurrentModificationException по принципу наилучшего соответствия. Поэтому неправильно создавать программу, которая полагалась бы на это исключение для правильности работы: поведение быстропроверяемых итераторов следует использовать только для обнаружения ошибок.

Начиная с платформы Java 2 v1.2, этот класс был переработан для реализации интерфейса List, сделав его членом Java Collections Framework. В отличие от новых реализаций коллекций, Vector синхронизирован. Если не требуется потокобезопасная реализация, рекомендуется использовать ArrayList вместо Vector.

Since:

1.0

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`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)`	Возвращает представление части этого списка между 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] по elementData[elementCount-1] являются фактическими элементами.

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, если такого индекса нет.

Specified by:: lastIndexOf в интерфейсе List<E>
Overrides:: lastIndexOf в классе AbstractList<E>
Parameters:: o - искомый элемент
Returns:: индекс последнего вхождения указанного элемента в этот вектор, или -1, если этот вектор не содержит элемент

lastIndexOf

public int lastIndexOf(Object o, int index)

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

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

elementAt

public E elementAt(int index)

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

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

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

firstElement

public E firstElement()

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

Returns:: первый компонент этого вектора
Throws:: NoSuchElementException - если у этого вектора нет компонентов

lastElement

public E lastElement()

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

Returns:: последний компонент вектора, т.е. компонент с индексом size() - 1
Throws:: NoSuchElementException - если этот вектор пустой

setElementAt

public void setElementAt(E obj, int index)

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

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

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

Parameters:: obj - значение, в которое будет установлен компонент; index - указанный индекс
Throws:: 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()

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

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 будет пустым (если только не произойдет исключение).

Specified by:: clear в интерфейсе Collection<E>
Specified by:: clear в интерфейсе List<E>
Overrides:: clear в классе AbstractList<E>
Since:: 1.2

containsAll

public boolean containsAll(Collection<?> c)

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

Specified by:

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

Specified by:

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

Overrides:

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

Parameters:

c - объект Collection, элементы которого будут проверены на наличие в этом объекте Vector

Returns:

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

Throws:

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

See Also:

AbstractCollection.contains(Object)

addAll

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

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

Specified by:

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

Specified by:

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

Overrides:

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

Parameters:

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

Returns:

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

Throws:

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

Since:

1.2

See Also:

AbstractCollection.add(Object)

removeAll

public boolean removeAll(Collection<?> c)

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

Specified by:

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

Specified by:

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

Overrides:

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

Parameters:

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

Returns:

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

Throws:

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

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

Since:

1.2

See Also:

retainAll

public boolean retainAll(Collection<?> c)

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

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:

removeIf

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

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

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

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)

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

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

equals

public boolean equals(Object o)

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

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:

hashCode

public int hashCode()

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

Specified by:

hashCode in interface Collection<E>

Specified by:

hashCode in interface List<E>

Overrides:

hashCode in class AbstractList<E>

Returns:

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

See Also:

toString

public String toString()

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

Overrides:: toString in class AbstractCollection<E>
Returns:: строковое представление этого набора

subList

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

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

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

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

Аналогичные конструкции могут быть построены для indexOf и lastIndexOf, а все алгоритмы в классе Collections могут быть применены к subList.

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

Specified by:: subList in interface List<E>
Overrides:: subList in class AbstractList<E>
Parameters:: fromIndex - низкая граница (включительно) subList; toIndex - высокая граница (исключительно) subList
Returns:: представление указанного диапазона в этом списке
Throws:: IndexOutOfBoundsException - если значение индекса конечной точки находится вне диапазона (fromIndex < 0 || toIndex > size); IllegalArgumentException - если индексы конечных точек расположены в неправильном порядке (fromIndex > toIndex)

removeRange

protected void removeRange(int fromIndex, int toIndex)

Удаляет из этого списка все элементы, индекс которых находится между fromIndex, включительно, и toIndex, не включительно. Смещает любые последующие элементы влево (уменьшает их индекс). Этот вызов укорачивает список на (toIndex - fromIndex) элементов. (Если toIndex==fromIndex, эта операция не имеет эффекта.)

Overrides:: removeRange in class AbstractList<E>
Parameters:: fromIndex - индекс первого удаляемого элемента; toIndex - индекс после последнего удаляемого элемента

listIterator

public ListIterator<E> listIterator(int index)

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

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)

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

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

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

Указано в:: forEach в интерфейсе Iterable<E>
Параметры:: action - Действие, которое должно быть выполнено для каждого элемента
Исключение:: NullPointerException - если указанное действие равно null

replaceAll

public void replaceAll(UnaryOperator<E> operator)

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

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

Указано в:: replaceAll в интерфейсе List<E>
Параметры:: operator - оператор, который нужно применить к каждому элементу
Исключение:: NullPointerException - если указанный оператор равен null или результат оператора равен null, и этот список не допускает null-элементы (опционально)

spliterator

public Spliterator<E> spliterator()

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

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

Указано в:: spliterator в интерфейсе Collection<E>
Указано в:: spliterator в интерфейсе Iterable<E>
Указано в:: spliterator в интерфейсе List<E>
Возвращает:: Spliterator над элементами в этом списке
С:: 1.8

© 1993, 2021, 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/17/docs/api/java.base/java/util/Vector.html