Класс CopyOnWriteArrayList<E>

CopyOnWriteArrayList

public CopyOnWriteArrayList()

CopyOnWriteArrayList

public CopyOnWriteArrayList(Collection<? extends E> c)

Параметры:

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

Исключения:

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

CopyOnWriteArrayList

public CopyOnWriteArrayList(E[] toCopyIn)

Параметры:

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

Исключения:

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

size

public int size()

Указано в:

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

Указано в:

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

Возвращает:

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

isEmpty

public boolean isEmpty()

Указано в:

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

Указано в:

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

Возвращает:

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

contains

public boolean contains(Object o)

Указано в:

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

Указано в:

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

Параметры:

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

Возвращает:

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

indexOf

public int indexOf(Object o)

Указано в:

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

Параметры:

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

Возвращает:

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

indexOf

public int indexOf(E e, int index)

Параметры:

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

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

Возвращает:

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

Исключения:

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

lastIndexOf

public int lastIndexOf(Object o)

Указано в:

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

Параметры:

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

Возвращает:

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

lastIndexOf

public int lastIndexOf(E e, int index)

Параметры:

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

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

Возвращает:

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

Исключения:

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

clone

public Object clone()

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

clone в классе Object

Возвращает:

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

См. также:

• Cloneable

toArray

public Object[] toArray()

Указано в:

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

Указано в:

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

Возвращает:

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

См. также:

• Arrays.asList(Object[])

toArray

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

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

Указано в:

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

Указано в:

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

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

T - компонентный тип массива для хранения коллекции

Параметры:

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

Возвращает:

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

Исключения:

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

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

get

public E get(int index)

Указано в:

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

Параметры:

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

Возвращает:

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

Исключения:

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

getFirst

public E getFirst()

Указано в:

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

Указано в:

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

Возвращает:

извлечённый элемент

Исключения:

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

С версии:

21

getLast

public E getLast()

Указано в:

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

Указано в:

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

Возвращает:

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

Исключение:

NoSuchElementException - если этот набор пуст

С:

21

set

public E set(int index, E element)

Указано в:

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

Параметры:

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

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

Возвращает:

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

Исключение:

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

add

public boolean add(E e)

Указано в:

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

Указано в:

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

Параметры:

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

Возвращает:

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

add

public void add(int index, E element)

Указано в:

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

Параметры:

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

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

Исключение:

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

addFirst

public void addFirst(E e)

Указано в:

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

Указано в:

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

Параметры:

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

С:

21

addLast

public void addLast(E e)

Указано в:

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

Указано в:

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

Параметры:

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

С:

21

remove

public E remove(int index)

Указано в:

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

Параметры:

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

Возвращает:

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

Исключение:

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

removeFirst

public E removeFirst()

Указано в:

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

Указано в:

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

Возвращает:

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

Исключение:

NoSuchElementException - если этот набор пуст

С:

21

removeLast

public E removeLast()

Указано в:

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

Указано в:

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

Возвращает:

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

Исключение:

NoSuchElementException - если этот набор пуст

С:

21

remove

public boolean remove(Object o)

Указано в:

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

Указано в:

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

Параметры:

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

Возвращает:

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

addIfAbsent

public boolean addIfAbsent(E e)

Параметры:

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

Возвращает:

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

containsAll

public boolean containsAll(Collection<?> c)

Указано в:

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

Указано в:

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

Параметры:

c - набор, который нужно проверить на включение в этот список

Возвращает:

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

Исключение:

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

См. также:

• contains(Object)

removeAll

public boolean removeAll(Collection<?> c)

Указано в:

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

Указано в:

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

Параметры:

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

Возвращает:

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

Исключение:

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

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

См. также:

• remove(Object)

retainAll

public boolean retainAll(Collection<?> c)

Указано в:

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

Указано в:

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

Параметры:

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

Возвращает:

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

Исключение:

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

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

См. также:

• remove(Object)

addAllAbsent

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

Параметры:

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

Возвращает:

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

Исключение:

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

См. также:

• addIfAbsent(Object)

clear

public void clear()

Указано в:

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

Указано в:

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

addAll

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

Указано в:

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

Указано в:

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

Параметры:

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

Возвращает:

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

Исключения:

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

См. также:

• add(Object)

addAll

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)

forEach

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

Указано в:

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

Параметры:

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

Исключения:

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

removeIf

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

Указано в:

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

Параметры:

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

Возвращает:

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

Исключения:

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

toString

public String toString()

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

toString в классе Object

Возвращает:

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

equals

public boolean equals(Object o)

Указано в:

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

Указано в:

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

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

equals в классе Object

Параметры:

o - объект, который необходимо сравнить на равенство с этим списком

Возвращает:

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

См. также:

• Object.hashCode()
• HashMap

hashCode

public int hashCode()

Указано в:

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

Указано в:

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

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

hashCode в классе Object

Возвращает:

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

См. также:

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

iterator

public Iterator<E> iterator()

Указано в:

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

Указано в:

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

Указано в:

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

Возвращает:

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

listIterator

public ListIterator<E> listIterator()

Указано в:

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

Возвращает:

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

listIterator

public ListIterator<E> listIterator(int index)

Указано в:

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

Параметры:

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

Возвращает:

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

Исключения:

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

spliterator

public Spliterator<E> spliterator()

Specified by:

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

Specified by:

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

Specified by:

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

Returns:

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

Since:

1.8

subList

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

Specified by:

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

Parameters:

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

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

Returns:

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

Throws:

IndexOutOfBoundsException - для некорректного индекса конечной точки (fromIndex < 0 || toIndex > size || fromIndex > toIndex)

reversed

public List<E> reversed()

Specified by:

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

Specified by:

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

Returns:

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

Since:

21