Класс 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

Возвращает:

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