Класс AbstractCollection<E>

protected AbstractCollection()

public abstract Iterator<E> iterator()

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

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

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

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

Возвращает:

итератор для элементов, содержащихся в этой коллекции

public boolean isEmpty()

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

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

Требования к реализации:

Эта реализация возвращает size() == 0.

Возвращает:

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

public boolean contains(Object o)

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

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

Требования к реализации:

Эта реализация перебирает элементы коллекции, последовательно проверяя каждый элемент на равенство указанному элементу.

Параметры:

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

Возвращает:

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

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

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

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

public Object[] toArray()

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

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

Требования к реализации:

Эта реализация возвращает массив, содержащий все элементы, возвращенные итератором этой коллекции, в том же порядке и в последовательных ячейках массива, начиная с индекса 0. Длина возвращаемого массива равна числу элементов, возвращенных итератором, даже если размер этой коллекции изменится во время итерации, что может произойти, если коллекция допускает параллельное изменение во время итерации. Метод size вызывается только в качестве подсказки для оптимизации; правильный результат возвращается, даже если итератор возвращает другое число элементов.

Этот метод эквивалентен:

List<E> list = new ArrayList<E>(size());
for (E e : this)
    list.add(e);
return list.toArray();

Возвращает:

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

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

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

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

Требования к реализации:

Эта реализация возвращает массив, содержащий все элементы, возвращенные итератором этой коллекции, в том же порядке и в последовательных ячейках массива, начиная с индекса 0. Если число элементов, возвращенных итератором, слишком велико, чтобы поместиться в указанный массив, элементы возвращаются в новом массиве, длина которого равна числу элементов, возвращенных итератором, даже если размер этой коллекции изменится во время итерации, что может произойти, если коллекция допускает параллельное изменение во время итерации. Метод size вызывается только в качестве подсказки для оптимизации; правильный результат возвращается, даже если итератор возвращает другое число элементов.

Этот метод эквивалентен:

List<E> list = new ArrayList<E>(size());
for (E e : this)
    list.add(e);
return list.toArray(a);

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

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

Параметры:

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

Возвращает:

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

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

ArrayStoreException - если тип во время выполнения любого элемента этой коллекции нельзя присвоить типу компонента во время выполнения указанного массива

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

public boolean add(E e)

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

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

Требования к реализации:

Эта реализация всегда выбрасывает UnsupportedOperationException.

Параметры:

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

Возвращает:

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

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

UnsupportedOperationException - если эта коллекция не поддерживает операцию add

ClassCastException - если класс указанного элемента не позволяет добавить его в эту коллекцию

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

IllegalArgumentException - если какое-либо свойство элемента не позволяет добавить его в эту коллекцию

IllegalStateException - если в данный момент элемент нельзя добавить из-за ограничений на вставку

public boolean remove(Object o)

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

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

Требования к реализации:

Эта реализация перебирает коллекцию в поисках указанного элемента. Если элемент найден, он удаляется из коллекции с помощью метода итератора remove.

Обратите внимание: эта реализация выбрасывает UnsupportedOperationException, если итератор, возвращаемый методом iterator этой коллекции, не реализует метод remove, а эта коллекция содержит указанный объект.

Параметры:

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

Возвращает:

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

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

UnsupportedOperationException - если эта коллекция не поддерживает операцию remove

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

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

public boolean containsAll(Collection<?> c)

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

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

Требования к реализации:

Эта реализация перебирает указанную коллекцию, последовательно проверяя каждый возвращаемый итератором элемент на наличие в этой коллекции. Если все элементы содержатся в ней, возвращается true, в противном случае — false.

Параметры:

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

Возвращает:

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

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

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

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

См. также:

• contains(Object)

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

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

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

Требования к реализации:

Эта реализация перебирает указанную коллекцию и последовательно добавляет в эту коллекцию каждый объект, возвращенный итератором.

Обратите внимание: эта реализация выбросит UnsupportedOperationException, если метод add не переопределен (при условии, что указанная коллекция не пуста).

Параметры:

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

Возвращает:

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

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

UnsupportedOperationException - если эта коллекция не поддерживает операцию addAll

ClassCastException - если класс элемента указанной коллекции не позволяет добавить его в эту коллекцию

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

IllegalArgumentException - если какое-либо свойство элемента указанной коллекции не позволяет добавить его в эту коллекцию

IllegalStateException - если в данный момент нельзя добавить все элементы из-за ограничений на вставку

См. также:

• add(Object)

public boolean removeAll(Collection<?> c)

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

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

Требования к реализации:

Эта реализация перебирает эту коллекцию, последовательно проверяя каждый возвращаемый итератором элемент на наличие в указанной коллекции. Если элемент содержится в ней, он удаляется из этой коллекции с помощью метода итератора remove.

Обратите внимание: эта реализация выбросит UnsupportedOperationException, если итератор, возвращаемый методом iterator, не реализует метод remove, а эта коллекция содержит один или несколько общих элементов с указанной коллекцией.

Параметры:

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

Возвращает:

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

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

UnsupportedOperationException - если эта коллекция не поддерживает операцию removeAll

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

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

См. также:

• remove(Object)
• contains(Object)

public boolean retainAll(Collection<?> c)

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

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

Требования к реализации:

Эта реализация перебирает эту коллекцию, последовательно проверяя каждый возвращаемый итератором элемент на наличие в указанной коллекции. Если элемент не содержится в ней, он удаляется из этой коллекции с помощью метода итератора remove.

Обратите внимание: эта реализация выбросит UnsupportedOperationException, если итератор, возвращаемый методом iterator, не реализует метод remove, а эта коллекция содержит один или несколько элементов, отсутствующих в указанной коллекции.

Параметры:

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

Возвращает:

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

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

UnsupportedOperationException - если эта коллекция не поддерживает операцию retainAll

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

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

См. также:

• remove(Object)
• contains(Object)

public void clear()

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

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

Требования к реализации:

Эта реализация перебирает эту коллекцию, удаляя каждый элемент с помощью операции Iterator.remove. Для повышения эффективности большинство реализаций, вероятно, предпочтут переопределить этот метод.

Обратите внимание: эта реализация выбросит UnsupportedOperationException, если итератор, возвращаемый методом iterator этой коллекции, не реализует метод remove, а эта коллекция не пуста.

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

UnsupportedOperationException - если эта коллекция не поддерживает операцию clear

public String toString()

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

toString в классе Object

Возвращает:

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