Класс 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 equals(Object o)

Определён в:

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

Определён в:

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

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

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

Параметры:

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

Возвращает:

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

См. также:

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

public int hashCode()

Определён в:

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

Определён в:

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

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

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

Возвращает:

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

См. также:

• Object.hashCode()
• Object.equals(Object)

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 — нижняя граница подсписка (включительно)

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

Возвращает:

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

Исключения:

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