Класс CopyOnWriteArrayList<E>

public CopyOnWriteArrayList()

public CopyOnWriteArrayList(Collection<? extends E> c)

Параметры:

c — коллекция изначально содержащихся элементов

Исключения:

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

public CopyOnWriteArrayList(E[] toCopyIn)

Параметры:

toCopyIn — массив (в качестве внутреннего массива используется его копия)

Исключения:

NullPointerException — если указанный массив равен null

public int size()

Определено в:

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

Определено в:

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

Возвращает:

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

public boolean isEmpty()

Определено в:

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

Определено в:

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

Возвращает:

true, если этот список не содержит элементов

public boolean contains(Object o)

Определено в:

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

Определено в:

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

Параметры:

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

Возвращает:

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

public int indexOf(Object o)

Определено в:

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

Параметры:

o — искомый элемент

Возвращает:

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

public int indexOf(E e, int index)

Параметры:

e — искомый элемент

index — индекс, с которого начинается поиск

Возвращает:

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

Исключения:

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

public int lastIndexOf(Object o)

Определено в:

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

Параметры:

o — искомый элемент

Возвращает:

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

public int lastIndexOf(E e, int index)

Параметры:

e — искомый элемент

index — индекс, с которого начинается поиск назад

Возвращает:

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

Исключения:

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

public Object clone()

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

clone в классе Object

Возвращает:

клон этого списка

См. также:

• Cloneable

public Object[] toArray()

Определено в:

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

Определено в:

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

Возвращает:

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

См. также:

• Arrays.asList(Object[])

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

 String[] y = x.toArray(new String[0]);

Определено в:

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

Определено в:

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

Параметры типа:

T — тип компонентов массива, в котором будет храниться коллекция

Параметры:

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

Возвращает:

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

Исключения:

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

NullPointerException — если указанный массив равен null

public E get(int index)

Определено в:

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

Параметры:

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

Возвращает:

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

Исключения:

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

public E getFirst()

Определено в:

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

Определено в:

getFirst в интерфейсе SequencedCollection<E>

Возвращает:

полученный элемент

Исключения:

NoSuchElementException — если эта коллекция пуста

Начиная с версии:

21

public E getLast()

Определено в:

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

Определено в:

getLast в интерфейсе SequencedCollection<E>

Возвращает:

полученный элемент

Исключения:

NoSuchElementException — если эта коллекция пуста

Начиная с версии:

21

public E set(int index, E element)

Определено в:

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

public boolean add(E e)

Определено в:

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

Определено в:

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

Параметры:

e — элемент, добавляемый в конец этого списка

Возвращает:

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

public void add(int index, E element)

Определено в:

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

Параметры:

index — позиция, в которую нужно вставить указанный элемент

element — вставляемый элемент

Исключения:

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

public void addFirst(E e)

Определено в:

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

Определено в:

addFirst в интерфейсе SequencedCollection<E>

Параметры:

e — добавляемый элемент

Начиная с версии:

21

public void addLast(E e)

Определено в:

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

Определено в:

addLast в интерфейсе SequencedCollection<E>

Параметры:

e — добавляемый элемент.

Начиная с версии:

21

public E remove(int index)

Определено в:

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

Параметры:

index — индекс удаляемого элемента

Возвращает:

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

Исключения:

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

public E removeFirst()

Определено в:

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

Определено в:

removeFirst в интерфейсе SequencedCollection<E>

Возвращает:

удалённый элемент

Исключения:

NoSuchElementException — если эта коллекция пуста

Начиная с версии:

21

public E removeLast()

Определено в:

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

Определено в:

removeLast в интерфейсе SequencedCollection<E>

Возвращает:

удалённый элемент

Исключения:

NoSuchElementException — если эта коллекция пуста

Начиная с версии:

21

public boolean remove(Object o)

Определено в:

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

Определено в:

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

Параметры:

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

Возвращает:

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

public boolean addIfAbsent(E e)

Параметры:

e — элемент, добавляемый в этот список, если он отсутствует

Возвращает:

true, если элемент был добавлен

public boolean containsAll(Collection<?> c)

Определено в:

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

Определено в:

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

Параметры:

c — коллекция, наличие элементов которой проверяется в этом списке

Возвращает:

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

Исключения:

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

См. также:

• contains(Object)

public boolean removeAll(Collection<?> c)

Определено в:

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

Определено в:

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

Параметры:

c — коллекция, содержащая элементы, которые нужно удалить из этого списка

Возвращает:

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

Исключения:

ClassCastException — если класс элемента этого списка несовместим с указанной коллекцией (необязательно)

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

См. также:

• remove(Object)

public boolean retainAll(Collection<?> c)

Определено в:

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

Определено в:

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

Параметры:

c — коллекция, содержащая элементы, которые нужно оставить в этом списке

Возвращает:

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

Исключения:

ClassCastException — если класс элемента этого списка несовместим с указанной коллекцией (необязательно)

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

См. также:

• remove(Object)

public int addAllAbsent(Collection<? extends E> c)

Параметры:

c — коллекция, содержащая элементы, которые нужно добавить в этот список

Возвращает:

количество добавленных элементов

Исключения:

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

См. также:

• addIfAbsent(Object)

public void clear()

Определено в:

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

Определено в:

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

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

Определено в:

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

Определено в:

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

Параметры:

c — коллекция, содержащая элементы, которые нужно добавить в этот список

Возвращает:

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

Исключения:

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

См. также:

• add(Object)

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

Определено в:

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

Параметры:

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

c — коллекция, содержащая элементы, которые нужно добавить в этот список

Возвращает:

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

Исключения:

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

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

См. также:

• add(int,Object)

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

Определено в:

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

Параметры:

action — действие, выполняемое для каждого элемента

Исключения:

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

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

Определено в:

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

Параметры:

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

Возвращает:

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

Исключения:

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

public String toString()

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

toString в классе Object

Возвращает:

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

public boolean equals(Object o)

Определено в:

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

Определено в:

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

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

equals в классе Object

Параметры:

o — объект, который требуется сравнить с этим списком на равенство

Возвращает:

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

См. также:

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

public int hashCode()

Определено в:

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

Определено в:

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

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

hashCode в классе Object

Возвращает:

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

См. также:

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

public Iterator<E> iterator()

Определено в:

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

Определено в:

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

Определено в:

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

Возвращает:

итератор по элементам этого списка в надлежащем порядке

public ListIterator<E> listIterator()

Определено в:

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

Возвращает:

итератор списка по элементам этого списка (в надлежащем порядке)

public ListIterator<E> listIterator(int index)

Определено в:

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

Параметры:

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

Возвращает:

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

Выбрасывает:

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

public Spliterator<E> spliterator()

Определено в:

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

Определено в:

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

Определено в:

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

Возвращает:

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

С версии:

1.8

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

Определено в:

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

Параметры:

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

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

Возвращает:

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

Выбрасывает:

IndexOutOfBoundsException — при недопустимом значении индекса границы (fromIndex < 0 || toIndex > size || fromIndex > toIndex)

public List<E> reversed()

Определено в:

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

Определено в:

reversed в интерфейсе SequencedCollection<E>

Возвращает:

представление этой коллекции с обратным порядком элементов в виде List

С версии:

21