it.unimi.dsi.fastutil.ints.AbstractIntCollection

All Implemented Interfaces:: IntCollection, IntIterable, Iterable<Integer>, Collection<Integer>

Direct Known Subclasses:: AbstractIntBigList, AbstractIntList, AbstractIntSet, IntCollections.EmptyCollection, IntCollections.IterableCollection

public abstract class AbstractIntCollection
extends AbstractCollection<Integer>
implements IntCollection

An abstract class providing basic methods for collections implementing a type-specific interface.

In particular, this class provide iterator(), add(), remove(Object) and contains(Object) methods that just call the type-specific counterpart.

Warning: Because of a name clash between the list and collection interfaces the type-specific deletion method of a type-specific abstract collection is rem(), rather then remove(). A subclass must thus override rem(), rather than remove(), to make all inherited methods work properly.

Method Summary

Modifier and Type	Method	Description
`boolean`	`add(int k)`	Ensures that this collection contains the specified element (optional operation).
`boolean`	`add(Integer key)`	Deprecated. Please use the corresponding type-specific method instead.
`boolean`	`addAll(IntCollection c)`	Adds all elements of the given type-specific collection to this collection.
`boolean`	`contains(int k)`	Returns `true` if this collection contains the specified element.
`boolean`	`contains(Object key)`	Deprecated. Please use the corresponding type-specific method instead.
`boolean`	`containsAll(IntCollection c)`	Checks whether this collection contains all elements from the given type-specific collection.
`abstract IntIterator`	`iterator()`	Returns a type-specific iterator on the elements of this collection.
`boolean`	`rem(int k)`	Removes a single instance of the specified element from this collection, if it is present (optional operation).
`boolean`	`remove(Object key)`	Deprecated. Please use the corresponding type-specific method instead.
`boolean`	`removeAll(IntCollection c)`	Remove from this collection all elements in the given type-specific collection.
`boolean`	`retainAll(IntCollection c)`	Retains in this collection only elements from the given type-specific collection.
`int[]`	`toArray(int[] a)`	Returns an array containing all of the elements in this collection; the runtime type of the returned array is that of the specified array.
`int[]`	`toIntArray()`	Returns a primitive type array containing the items of this collection.
`int[]`	`toIntArray(int[] a)`	Deprecated. Please use `toArray()` instead—this method is redundant and will be removed in the future.
`String`	`toString()`

Methods inherited from class java.util.AbstractCollection

addAll, clear, containsAll, isEmpty, removeAll, retainAll, size, toArray, toArray

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection

addAll, clear, containsAll, equals, hashCode, isEmpty, parallelStream, removeAll, retainAll, size, spliterator, stream, toArray, toArray, toArray

Methods inherited from interface it.unimi.dsi.fastutil.ints.IntCollection

removeIf, removeIf

Methods inherited from interface it.unimi.dsi.fastutil.ints.IntIterable

forEach, forEach

Method Details
- iterator
  
  public abstract IntIterator iterator()
  
  Description copied from interface: IntCollection
  
  Returns a type-specific iterator on the elements of this collection.
  Note that this specification strengthens the one given in Iterable.iterator(), which was already strengthened in the corresponding type-specific class, but was weakened by the fact that this interface extends Collection.
  
  Specified by:
  
  iterator in interface Collection<Integer>
  
  Specified by:
  
  iterator in interface IntCollection
  
  Specified by:
  
  iterator in interface IntIterable
  
  Specified by:
  
  iterator in interface Iterable<Integer>
  
  Specified by:
  
  iterator in class AbstractCollection<Integer>
  
  Returns:
  
  a type-specific iterator on the elements of this collection.
  
  See Also:
  
  Iterable.iterator()
- add
  
  public boolean add(int k)
  
  Ensures that this collection contains the specified element (optional operation).
  This implementation always throws an UnsupportedOperationException.
  
  Specified by:
  
  add in interface IntCollection
  
  See Also:
  
  Collection.add(Object)
- contains
  
  public boolean contains(int k)
  
  Returns true if this collection contains the specified element.
  This implementation iterates over the elements in the collection, looking for the specified element.
  
  Specified by:
  
  contains in interface IntCollection
  
  See Also:
  
  Collection.contains(Object)
- rem
  
  public boolean rem(int k)
  
  Removes a single instance of the specified element from this collection, if it is present (optional operation).
  Note that this method should be called remove(), but the clash with the similarly named index-based method in the List interface forces us to use a distinguished name. For simplicity, the set interfaces reinstates remove().
  This implementation iterates over the elements in the collection, looking for the specified element and tries to remove it.
  
  Specified by:
  
  rem in interface IntCollection
  
  See Also:
  
  Collection.remove(Object)
- add
  
  @Deprecated public boolean add(Integer key)
  
  Deprecated.
  Please use the corresponding type-specific method instead.
  
  Specified by:
  
  add in interface Collection<Integer>
  
  Specified by:
  
  add in interface IntCollection
  
  Overrides:
  
  add in class AbstractCollection<Integer>
- contains
  
  @Deprecated public boolean contains(Object key)
  
  Deprecated.
  Please use the corresponding type-specific method instead.
  
  Specified by:
  
  contains in interface Collection<Integer>
  
  Specified by:
  
  contains in interface IntCollection
  
  Overrides:
  
  contains in class AbstractCollection<Integer>
- remove
  
  @Deprecated public boolean remove(Object key)
  
  Deprecated.
  Please use the corresponding type-specific method instead.
  
  Specified by:
  
  remove in interface Collection<Integer>
  
  Specified by:
  
  remove in interface IntCollection
  
  Overrides:
  
  remove in class AbstractCollection<Integer>
- toArray
  
  public int[] toArray(int[] a)
  
  Description copied from interface: IntCollection
  
  Returns an array containing all of the elements in this collection; the runtime type of the returned array is that of the specified array.
  Note that, contrarily to Collection.toArray(Object[]), this methods just writes all elements of this collection: no special value will be added after the last one.
  
  Specified by:
  
  toArray in interface IntCollection
  
  Parameters:
  
  a - if this array is big enough, it will be used to store this collection.
  
  Returns:
  
  a primitive type array containing the items of this collection.
  
  See Also:
  
  Collection.toArray(Object[])
- toIntArray
  
  public int[] toIntArray()
  
  Description copied from interface: IntCollection
  
  Returns a primitive type array containing the items of this collection.
  
  Specified by:
  
  toIntArray in interface IntCollection
  
  Returns:
  
  a primitive type array containing the items of this collection.
  
  See Also:
  
  Collection.toArray()
- toIntArray
  
  @Deprecated public int[] toIntArray(int[] a)
  
  Deprecated.
  Please use toArray() instead—this method is redundant and will be removed in the future.
  
  Returns a primitive type array containing the items of this collection.
  Note that, contrarily to Collection.toArray(Object[]), this methods just writes all elements of this collection: no special value will be added after the last one.
  
  Specified by:
  
  toIntArray in interface IntCollection
  
  Parameters:
  
  a - if this array is big enough, it will be used to store this collection.
  
  Returns:
  
  a primitive type array containing the items of this collection.
  
  See Also:
  
  Collection.toArray(Object[])
- addAll
  
  public boolean addAll(IntCollection c)
  
  Description copied from interface: IntCollection
  
  Adds all elements of the given type-specific collection to this collection.
  
  Specified by:
  
  addAll in interface IntCollection
  
  Parameters:
  
  c - a type-specific collection.
  
  Returns:
  
  true if this collection changed as a result of the call.
  
  See Also:
  
  Collection.addAll(Collection)
- containsAll
  
  public boolean containsAll(IntCollection c)
  
  Description copied from interface: IntCollection
  
  Checks whether this collection contains all elements from the given type-specific collection.
  
  Specified by:
  
  containsAll in interface IntCollection
  
  Parameters:
  
  c - a type-specific collection.
  
  Returns:
  
  true if this collection contains all elements of the argument.
  
  See Also:
  
  Collection.containsAll(Collection)
- removeAll
  
  public boolean removeAll(IntCollection c)
  
  Description copied from interface: IntCollection
  
  Remove from this collection all elements in the given type-specific collection.
  
  Specified by:
  
  removeAll in interface IntCollection
  
  Parameters:
  
  c - a type-specific collection.
  
  Returns:
  
  true if this collection changed as a result of the call.
  
  See Also:
  
  Collection.removeAll(Collection)
- retainAll
  
  public boolean retainAll(IntCollection c)
  
  Description copied from interface: IntCollection
  
  Retains in this collection only elements from the given type-specific collection.
  
  Specified by:
  
  retainAll in interface IntCollection
  
  Parameters:
  
  c - a type-specific collection.
  
  Returns:
  
  true if this collection changed as a result of the call.
  
  See Also:
  
  Collection.retainAll(Collection)
- toString
  
  public String toString()
  
  Overrides:
  
  toString in class AbstractCollection<Integer>