compact1, compact2, compact3

java.util

Вектор класса <E>

java.lang. Объект

java.util. AbstractCollection<E>

java.util. AbstractList <E>

java.util. Вектор <E>

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable, Повторяемый <E>, Набор <E>, Список <E>, RandomAccess

Прямые Известные Подклассы:

Стек

public class Vector<E>
extends AbstractList<E>
implements List<E>, RandomAccess, Cloneable, Serializable

Vector class реализует growable массив объектов. Как массив, это содержит компоненты, к которым можно получить доступ, используя целое число, индексируют. Однако, размер a Vector может вырасти или уменьшиться как необходимый разместить добавление и удаление элементов после Vector был создан.

Каждый вектор пытается оптимизировать управление хранением, поддерживая a capacity и a capacityIncrement. capacity является всегда, по крайней мере, столь же большим как векторный размер; это обычно больше, потому что, поскольку компоненты добавляются к вектору, увеличениям хранения вектора блоков размер capacityIncrement. Приложение может увеличить емкость вектора прежде, чем вставить большое количество компонентов; это уменьшает количество инкрементного перераспределения.

iterators возвратился этим class iterator и listIterator методы являются сбоем быстро: если вектор структурно изменяется когда-либо после того, как iterator создается, всегда кроме через собственный iterator's remove или add методы, iterator бросит a ConcurrentModificationException. Таким образом, перед лицом параллельной модификации, iterator перестал работать быстро и чисто, вместо того, чтобы рискнуть произвольным, недетерминированным поведением в неопределенное время в будущем. Enumerations возвращенный elements метод не является сбоем быстро.

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

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

С тех пор:

JDK1.0

См. Также:

Collection, LinkedList, Сериализированная Форма

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected int	capacityIncrement Количество, которым автоматически постепенно увеличивается емкость вектора, когда его размер становится больше чем его емкость.
protected int	elementCount Число допустимых компонентов в этом Vector объект.
protected Object[]	elementData Буфер массива, в который сохранены компоненты вектора.

Поля, наследованные от class java.util. AbstractList

modCount

Сводка конструктора

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

Конструктор и Описание
Vector() Создает пустой вектор так, чтобы у его внутреннего массива данных был размер 10 и его стандартный инкремент емкости является нулем.
Vector(Collection<? extends E> c) Создает вектор, содержащий элементы указанного набора, в порядке, они возвращаются iterator набора.
Vector(int initialCapacity) Создает пустой вектор с указанной начальной емкостью, и с ее емкостью постепенно увеличиваются равный нулю.
Vector(int initialCapacity, int capacityIncrement) Создает пустой вектор с указанным начальным инкрементом емкости и емкости.

Сводка метода

Модификатор и Тип	Метод и Описание
boolean	add(E e) Добавляет указанный элемент до конца этого Вектора.
void	add(int index, E element) Вставляет указанный элемент в указанной позиции в этом Векторе.
boolean	addAll(Collection<? extends E> c) Добавляет все элементы в указанном Наборе до конца этого Вектора, в порядке, что они возвращаются Iterator указанного Набора.
boolean	addAll(int index, Collection<? extends E> c) Вставляет все элементы в указанном Наборе в этот Вектор в указанной позиции.
void	addElement(E obj) Добавляет указанный компонент до конца этого вектора, увеличивая его размер одним.
int	capacity() Возвращает текущую емкость этого вектора.
void	clear() Удаляет все элементы от этого Вектора.
Объект	clone() Возвращает клона этого вектора.
boolean	contains(Object o) Возвраты true если этот вектор содержит указанный элемент.
boolean	containsAll(Collection<?> c) Возвращает true, если этот Вектор содержит все элементы в указанном Наборе.
void	copyInto(Object[] anArray) Копирует компоненты этого вектора в указанный массив.
E	elementAt(int index) Возвращается компонент в указанном индексируют.
Enumeration<E>	elements() Возвращает перечисление компонентов этого вектора.
void	ensureCapacity(int minCapacity) Увеличивает емкость этого вектора, в случае необходимости, чтобы гарантировать, что это может содержать, по крайней мере, число компонентов, определенных минимальным параметром емкости.
boolean	equals(Object o) Сравнивает указанный Объект с этим Вектором для равенства.
E	firstElement() Возвращает первый компонент (элемент в индексируют 0) из этого вектора.
void	forEach(Consumer<? super E> action) Выполняет данное действие на содержании Iterable, в порядке элементы происходят, выполняя итерации, пока все элементы не были обработаны, или действие выдает исключение.
E	get(int index) Возвращает элемент в указанной позиции в этом Векторе.
int	hashCode() Возвращает значение хэш-кода для этого Вектора.
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() Возвращает iterator по элементам в этом списке в надлежащей последовательности.
E	lastElement() Возвращает последний компонент вектора.
int	lastIndexOf(Object o) Возвращает индексирование последнего вхождения указанного элемента в этом векторе, или-1, если этот вектор не содержит элемент.
int	lastIndexOf(Object o, int index) Возвращает индексирование последнего вхождения указанного элемента в этом векторе, ища назад от index, или возвраты-1, если элемент не находится.
ListIterator<E>	listIterator() Возвращает список iterator по элементам в этом списке (в надлежащей последовательности).
ListIterator<E>	listIterator(int index) Возвращает список iterator по элементам в этом списке (в надлежащей последовательности), запускаясь в указанной позиции в списке.
E	remove(int index) Удаляет элемент в указанной позиции в этом Векторе.
boolean	remove(Object o) Удаляет первое возникновение указанного элемента в этом Векторе, Если Вектор не содержит элемент, это неизменно.
boolean	removeAll(Collection<?> c) Удаляет из этого Вектора все его элементы, которые содержатся в указанном Наборе.
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) Сохраняет только элементы в этом Векторе, которые содержатся в указанном Наборе.
E	set(int index, E element) Заменяет элемент в указанной позиции в этом Векторе с указанным элементом.
void	setElementAt(E obj, int index) Устанавливает компонент в указанном index из этого вектора, чтобы быть указанным объектом.
void	setSize(int newSize) Устанавливает размер этого вектора.
int	size() Возвращает число компонентов в этом векторе.
void	sort(Comparator<? super E> c) Сортирует этот список, используя предоставленный Comparator сравнить элементы.
Spliterator<E>	spliterator() Создает a Spliterator по элементам в этом списке.
List<E>	subList(int fromIndex, int toIndex) Возвращает представление части этого Списка между fromIndex, включительно, и toIndex, монопольным.
Объект[]	toArray() Возвращает массив, содержащий все элементы в этом Векторе в правильном порядке.
<T> T[]	toArray(T[] a) Возвращает массив, содержащий все элементы в этом Векторе в правильном порядке; тип времени выполнения возвращенного массива является типом указанного массива.
Строка	toString() Возвращает строковое представление этого Вектора, содержа Строковое представление каждого элемента.
void	trimToSize() Обрезает емкость этого вектора быть текущим размером вектора.

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

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

Методы, наследованные от интерфейса java.util. Набор

parallelStream, stream

Полевая Деталь

elementData

protected Object[] elementData

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

Любые элементы массива после последнего элемента в Векторе являются нулем.

elementCount

protected int elementCount

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

capacityIncrement

protected int capacityIncrement

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

Деталь конструктора

Вектор

public Vector(int initialCapacity,
              int capacityIncrement)

Создает пустой вектор с указанным начальным инкрементом емкости и емкости.

Параметры:

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

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

Броски:

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

Вектор

public Vector(int initialCapacity)

Создает пустой вектор с указанной начальной емкостью, и с ее емкостью постепенно увеличиваются равный нулю.

Параметры:

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

Броски:

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

Вектор

public Vector()

Создает пустой вектор так, чтобы у его внутреннего массива данных был размер 10 и его стандартный инкремент емкости является нулем.

Вектор

public Vector(Collection<? extends E> c)

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

Параметры:

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

Броски:

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

С тех пор:

1.2

Деталь метода

copyInto

public void copyInto(Object[] anArray)

Копирует компоненты этого вектора в указанный массив. Элемент в индексирует k в этом векторе копируется в компонент k из anArray.

Параметры:

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

Броски:

NullPointerException - если данный массив является нулем

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 - если новый размер отрицателен

емкость

public int capacity()

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

Возвраты:

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

размер

public int size()

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

Определенный:

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

Определенный:

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

Определенный:

size в class AbstractCollection<E>

Возвраты:

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

isEmpty

public boolean isEmpty()

Тесты, если у этого вектора нет никаких компонентов.

Определенный:

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

Определенный:

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

Переопределения:

isEmpty в class AbstractCollection<E>

Возвраты:

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

элементы

public Enumeration<E> elements()

Возвращает перечисление компонентов этого вектора. Возвращенный Enumeration объект генерирует все элементы в этом векторе. Первый сгенерированный элемент является элементом в, индексируют 0, тогда элемент в индексирует 1, и так далее.

Возвраты:

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

См. Также:

Iterator

содержит

public boolean contains(Object o)

Возвраты true если этот вектор содержит указанный элемент. Более формально, возвраты true если и только если этот вектор содержит по крайней мере один элемент e так, что (o==null ? e==null : o.equals(e)).

Определенный:

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

Определенный:

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

Переопределения:

contains в class AbstractCollection<E>

Параметры:

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

Возвраты:

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

indexOf

public int indexOf(Object o)

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

Определенный:

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

Переопределения:

indexOf в class AbstractList<E>

Параметры:

o - элемент, чтобы искать

Возвраты:

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

indexOf

public int indexOf(Object o,
                   int index)

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

Параметры:

o - элемент, чтобы искать

index - индексируйте, чтобы начать искать от

Возвраты:

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

Броски:

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

См. Также:

Object.equals(Object)

lastIndexOf

public int lastIndexOf(Object o)

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

Определенный:

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

Переопределения:

lastIndexOf в class AbstractList<E>

Параметры:

o - элемент, чтобы искать

Возвраты:

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

lastIndexOf

public int lastIndexOf(Object o,
                       int index)

Возвращает индексирование последнего вхождения указанного элемента в этом векторе, ища назад от index, или возвраты-1, если элемент не находится. Более формально, возвращается, самые высокие индексируют i так, что (i <= index && (o==null ? get(i)==null : o.equals(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 метод возвращает старое значение, которое было сохранено в указанной позиции.

Параметры:

index - индексирование объекта удалить

Броски:

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

insertElementAt

public void insertElementAt(E obj,
                            int index)

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

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

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

Параметры:

obj - компонент, чтобы вставить

index - где вставить новый компонент

Броски:

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

addElement

public void addElement(E obj)

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

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

Параметры:

obj - компонент, который будет добавлен

removeElement

public boolean removeElement(Object obj)

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

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

Параметры:

obj - компонент, который будет удален

Возвраты:

true если параметром был компонент этого вектора; false иначе.

removeAllElements

public void removeAllElements()

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

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

клон

public Object clone()

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

Переопределения:

clone в class Object

Возвраты:

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

См. Также:

Cloneable

toArray

public Object[] toArray()

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

Определенный:

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

Определенный:

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

Переопределения:

toArray в class AbstractCollection<E>

Возвраты:

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

С тех пор:

1.2

См. Также:

Arrays.asList(Object[])

toArray

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

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

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

Определенный:

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

Определенный:

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

Переопределения:

toArray в class AbstractCollection<E>

Параметры:

a - массив, в который должны быть сохранены элементы Вектора, если это является достаточно большим; иначе, новый массив того же самого типа времени выполнения выделяется с этой целью.

Возвраты:

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

Броски:

ArrayStoreException - если тип времени выполнения не супертип типа времени выполнения каждого элемента в этом Векторе

NullPointerException - если данный массив является нулем

С тех пор:

1.2

добраться

public E get(int index)

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

Определенный:

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

Определенный:

get в class AbstractList<E>

Параметры:

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

Возвраты:

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

Броски:

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

С тех пор:

1.2

набор

public E set(int index,
             E element)

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

Определенный:

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

Переопределения:

set в class AbstractList<E>

Параметры:

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

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

Возвраты:

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

Броски:

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

С тех пор:

1.2

добавить

public boolean add(E e)

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

Определенный:

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

Определенный:

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

Переопределения:

add в class AbstractList<E>

Параметры:

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

Возвраты:

true (как определено Collection.add(E))

С тех пор:

1.2

удалить

public boolean remove(Object o)

Удаляет первое возникновение указанного элемента в этом Векторе, Если Вектор не содержит элемент, это неизменно. Более формально, удаляет элемент с самым низким, индексируют меня так, что (o==null ? get(i)==null : o.equals(get(i))) (если такой элемент существует).

Определенный:

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

Определенный:

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

Переопределения:

remove в class AbstractCollection<E>

Параметры:

o - элемент, который будет удален из этого Вектора, если существующий

Возвраты:

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

С тех пор:

1.2

добавить

public void add(int index,
                E element)

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

Определенный:

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

Переопределения:

add в class AbstractList<E>

Параметры:

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

element - элемент, который будет вставлен

Броски:

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

С тех пор:

1.2

удалить

public E remove(int index)

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

Определенный:

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

Переопределения:

remove в class AbstractList<E>

Параметры:

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

Возвраты:

элемент, который был удален

Броски:

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

С тех пор:

1.2

очистить

public void clear()

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

Определенный:

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

Определенный:

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

Переопределения:

clear в class AbstractList<E>

С тех пор:

1.2

containsAll

public boolean containsAll(Collection<?> c)

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

Определенный:

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

Определенный:

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

Переопределения:

containsAll в class AbstractCollection<E>

Параметры:

c - набор, элементы которого будут протестированы на включение в этом Векторе

Возвраты:

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

Броски:

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

См. Также:

AbstractCollection.contains(Object)

addAll

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

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

Определенный:

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

Определенный:

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

Переопределения:

addAll в class AbstractCollection<E>

Параметры:

c - элементы, которые будут вставлены в этот Вектор

Возвраты:

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

Броски:

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

С тех пор:

1.2

См. Также:

AbstractCollection.add(Object)

removeAll

public boolean removeAll(Collection<?> c)

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

Определенный:

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

Определенный:

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

Переопределения:

removeAll в class AbstractCollection<E>

Параметры:

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

Возвраты:

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

Броски:

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

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

С тех пор:

1.2

См. Также:

AbstractCollection.remove(Object), AbstractCollection.contains(Object)

retainAll

public boolean retainAll(Collection<?> c)

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

Определенный:

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

Определенный:

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

Переопределения:

retainAll в class AbstractCollection<E>

Параметры:

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

Возвраты:

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

Броски:

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

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

С тех пор:

1.2

См. Также:

AbstractCollection.remove(Object), AbstractCollection.contains(Object)

addAll

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

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

Определенный:

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

Переопределения:

addAll в class AbstractList<E>

Параметры:

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

c - элементы, которые будут вставлены в этот Вектор

Возвраты:

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

Броски:

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

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

С тех пор:

1.2

равняется

public boolean equals(Object o)

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

Определенный:

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

Определенный:

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

Переопределения:

equals в class AbstractList<E>

Параметры:

o - Объект, который будет сравнен для равенства с этим Вектором

Возвраты:

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

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

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

Определенный:

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

Определенный:

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

Переопределения:

hashCode в class AbstractList<E>

Возвраты:

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

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

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

Переопределения:

toString в class AbstractCollection<E>

Возвраты:

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

подсписок

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

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

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

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

Подобные идиомы могут быть созданы для indexOf и lastIndexOf, и всех алгоритмов в Наборах, class может быть применен к подсписку.

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

Определенный:

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

Переопределения:

subList в class 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, эта работа не имеет никакого эффекта.)

Переопределения:

removeRange в class AbstractList<E>

Параметры:

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

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

listIterator

public ListIterator<E> listIterator(int index)

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

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

Определенный:

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

Переопределения:

listIterator в class AbstractList<E>

Параметры:

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

Возвраты:

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

Броски:

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

listIterator

public ListIterator<E> listIterator()

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

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

Определенный:

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

Переопределения:

listIterator в class AbstractList<E>

Возвраты:

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

См. Также:

listIterator(int)

iterator

public Iterator<E> iterator()

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

Возвращенный iterator является сбоем быстро.

Определенный:

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

Определенный:

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

Определенный:

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

Переопределения:

iterator в class AbstractList<E>

Возвраты:

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

forEach

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

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

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

Определенный:

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

Параметры:

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

removeIf

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

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

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

Определенный:

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

Параметры:

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

Возвраты:

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

replaceAll

public void replaceAll(UnaryOperator<E> operator)

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

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

Определенный:

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

Параметры:

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

вид

public void sort(Comparator<? super E> c)

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

Сортирует этот список, используя предоставленный Comparator сравнить элементы.

Определенный:

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

Параметры:

c - Comparator используемый, чтобы сравнить элементы списка. A null значение указывает, что естественное упорядочивание элементов должно использоваться

spliterator

public Spliterator<E> spliterator()

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

Создает a Spliterator по элементам в этом списке.

Spliterator отчеты Spliterator.SIZED и Spliterator.ORDERED. Реализации должны задокументировать создание отчетов дополнительных характеристических значений.

Определенный:

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

Определенный:

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

Возвраты:

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