Класс ArrayList<E>

public ArrayList(int initialCapacity)

Параметры:

initialCapacity — начальная емкость списка

Вызывает исключение:

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

public ArrayList()

public ArrayList(Collection<? extends E> c)

Параметры:

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

Вызывает исключение:

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

public void trimToSize()

public void ensureCapacity(int minCapacity)

Параметры:

minCapacity — требуемая минимальная емкость

public int size()

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

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

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

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

Возвращает:

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

public boolean isEmpty()

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

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

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

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

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

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

Возвращает:

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

public boolean contains(Object o)

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

public int indexOf(Object o)

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

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

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

indexOf в классе AbstractList<E>

Параметры:

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

Возвращает:

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

public int lastIndexOf(Object o)

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

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

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

lastIndexOf в классе AbstractList<E>

Параметры:

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

Возвращает:

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

public Object clone()

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

clone в классе Object

Возвращает:

клон этого экземпляра ArrayList

См. также:

• Cloneable

public Object[] toArray()

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

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

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

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

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

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

Возвращает:

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

См. также:

• Arrays.asList(Object[])

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

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

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

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

Вызывает исключение:

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

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

public E get(int index)

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

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

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

get в классе AbstractList<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>

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

set в классе AbstractList<E>

Параметры:

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

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

Возвращает:

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

Вызывает исключение:

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

public boolean add(E e)

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

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

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

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

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

add в классе AbstractList<E>

Параметры:

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

Возвращает:

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

public void add(int index, E element)

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

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

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

add в классе AbstractList<E>

Параметры:

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

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

Вызывает исключение:

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

public void addFirst(E element)

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

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

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

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

Параметры:

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

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

21

public void addLast(E element)

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

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

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

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

Параметры:

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

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

21

public E remove(int index)

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

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

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

remove в классе AbstractList<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>

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

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

Параметры:

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

Возвращает:

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

public void clear()

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

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

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

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

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

clear в классе AbstractList<E>

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

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

Вызывает исключение:

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

См. также:

• AbstractCollection.add(Object)

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

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

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

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

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

Параметры:

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

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

Возвращает:

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

Вызывает исключение:

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

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

protected void removeRange(int fromIndex, int toIndex)

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

removeRange в классе AbstractList<E>

Параметры:

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

toIndex — индекс, следующий за последним удаляемым элементом

Вызывает исключение:

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

public boolean removeAll(Collection<?> c)

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

Вызывает исключение:

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

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

См. также:

• Collection.contains(Object)

public boolean retainAll(Collection<?> c)

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

Вызывает исключение:

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

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

См. также:

• Collection.contains(Object)

public ListIterator<E> listIterator(int index)

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

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

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

listIterator в классе AbstractList<E>

Параметры:

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

Возвращает:

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

Вызывает исключение:

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

public ListIterator<E> listIterator()

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

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

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

listIterator в классе AbstractList<E>

Возвращает:

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

См. также:

• listIterator(int)

public Iterator<E> iterator()

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

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

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

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

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

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

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

iterator в классе AbstractList<E>

Возвращает:

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

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

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

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

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

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

subList в классе AbstractList<E>

Параметры:

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

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

Возвращает:

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

Вызывает исключение:

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

IllegalArgumentException — если индексы конечных точек указаны в неправильном порядке (fromIndex > toIndex)

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

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

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

Параметры:

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

Вызывает:

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

public Spliterator<E> spliterator()

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

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

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

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

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

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

Возвращает:

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

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

1.8

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

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

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

Параметры:

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

Возвращает:

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

Вызывает:

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