Класс AbstractCollection<E>

protected AbstractCollection()

public abstract Iterator<E> iterator()

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

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

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

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

Возвращает:

итератор по элементам, содержащимся в этом наборе

public boolean isEmpty()

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

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

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

Эта реализация возвращает true.

Возвращает:

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)

Specified by:

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

Implementation Requirements:

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

Parameters:

c - коллекция, для проверки на включение в эту коллекцию

Returns:

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

Throws:

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

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

See Also:

• contains(Object)

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

Specified by:

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

Implementation Requirements:

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

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

Parameters:

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

Returns:

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

Throws:

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

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

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

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

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

See Also:

• add(Object)

public boolean removeAll(Collection<?> c)

Specified by:

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

Implementation Requirements:

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

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

Parameters:

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

Returns:

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

Throws:

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

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

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

See Also:

• remove(Object)
• contains(Object)

public boolean retainAll(Collection<?> c)

Specified by:

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

Implementation Requirements:

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

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

Parameters:

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

Returns:

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

Throws:

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

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

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

See Also:

• remove(Object)
• contains(Object)

public void clear()

Specified by:

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

Implementation Requirements:

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

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

Throws:

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

public String toString()

Overrides:

toString в классе Object

Returns:

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