Класс ArrayList<E>

ArrayList

public ArrayList(int initialCapacity)

Параметры:

initialCapacity - начальная ёмкость списка

Исключения:

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

ArrayList

public ArrayList()

ArrayList

public ArrayList(Collection<? extends E> c)

Параметры:

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

Исключения:

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

trimToSize

public void trimToSize()

ensureCapacity

public void ensureCapacity(int minCapacity)

Параметры:

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

size

public int size()

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

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

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

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

Возвращает:

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

isEmpty

public boolean isEmpty()

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

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

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

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

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

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

Возвращает:

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

contains

public boolean contains(Object o)

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

indexOf

public int indexOf(Object o)

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

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

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

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

Параметры:

o - элемент, для которого нужно найти индекс

Возвращает:

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

lastIndexOf

public int lastIndexOf(Object o)

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

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

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

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

Параметры:

o - элемент, для которого нужно найти индекс

Возвращает:

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

clone

public Object clone()

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

clone в классе Object

Возвращает:

клонированный экземпляр ArrayList

См. также:

• Cloneable

toArray

public Object[] toArray()

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

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

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

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

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

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

Возвращает:

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

См. также:

• Arrays.asList(Object[])

toArray

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

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

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

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

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

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

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

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

T - тип компонентов массива, который должен содержать коллекцию

Параметры:

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

Возвращает:

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

Исключения:

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

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

get

public E get(int index)

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

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

set

public E set(int index, E element)

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

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

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

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

add

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 E remove(int index)

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

equals

public boolean equals(Object o)

Указано в:

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

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

См. также:

• Object.hashCode()
• HashMap

hashCode

public int hashCode()

Указано в:

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

Указано в:

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

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

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

Возвращает:

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

См. также:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.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>

addAll

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

Указано в:

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

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

См. также:

• AbstractCollection.add(Object)

addAll

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

removeRange

protected void removeRange(int fromIndex, int toIndex)

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

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

Параметры:

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

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

Исключения:

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

removeAll

public boolean removeAll(Collection<?> c)

Указано в:

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

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

См. также:

• Collection.contains(Object)

retainAll

public boolean retainAll(Collection<?> c)

Указано в:

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

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

См. также:

• Collection.contains(Object)

listIterator

public ListIterator<E> listIterator(int index)

Specified by:

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

Overrides:

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

Parameters:

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

Returns:

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

Throws:

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

listIterator

public ListIterator<E> listIterator()

Specified by:

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

Overrides:

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

Returns:

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

See Also:

• listIterator(int)

iterator

public Iterator<E> iterator()

Specified by:

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

Specified by:

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

Specified by:

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

Overrides:

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

Returns:

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

subList

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

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

Specified by:

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

Overrides:

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

Parameters:

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

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

Returns:

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

Throws:

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

IllegalArgumentException - если индексы конечных точек расположены в обратном порядке (fromIndex > toIndex)

forEach

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

Specified by:

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

Parameters:

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

Throws:

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

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

removeIf

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

Specified by:

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

Parameters:

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

Returns:

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

Throws:

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