Class AbstractIntCollection
- java.lang.Object
-
- java.util.AbstractCollection<Integer>
-
- 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)andcontains(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 thenremove(). A subclass must thus overriderem(), rather thanremove(), to make all inherited methods work properly.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods Modifier and Type Method Description booleanadd(int k)Ensures that this collection contains the specified element (optional operation).booleanadd(Integer key)Deprecated.Please use the corresponding type-specific method instead.booleanaddAll(IntCollection c)Adds all elements of the given type-specific collection to this collection.booleanaddAll(Collection<? extends Integer> c)booleancontains(int k)Returnstrueif this collection contains the specified element.booleancontains(Object key)Deprecated.Please use the corresponding type-specific method instead.booleancontainsAll(IntCollection c)Checks whether this collection contains all elements from the given type-specific collection.booleancontainsAll(Collection<?> c)abstract IntIteratoriterator()Returns a type-specific iterator on the elements of this collection.booleanrem(int k)Removes a single instance of the specified element from this collection, if it is present (optional operation).booleanremove(Object key)Deprecated.Please use the corresponding type-specific method instead.booleanremoveAll(IntCollection c)Remove from this collection all elements in the given type-specific collection.booleanremoveAll(Collection<?> c)booleanretainAll(IntCollection c)Retains in this collection only elements from the given type-specific collection.booleanretainAll(Collection<?> c)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 usetoArray()instead—this method is redundant and will be removed in the future.StringtoString()-
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface java.util.Collection
clear, equals, hashCode, isEmpty, parallelStream, 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 Detail
-
iterator
public abstract IntIterator iterator()
Description copied from interface:IntCollectionReturns 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 extendsCollection.- Specified by:
iteratorin interfaceCollection<Integer>- Specified by:
iteratorin interfaceIntCollection- Specified by:
iteratorin interfaceIntIterable- Specified by:
iteratorin interfaceIterable<Integer>- Specified by:
iteratorin classAbstractCollection<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:
addin interfaceIntCollection- See Also:
Collection.add(Object)
-
contains
public boolean contains(int k)
Returnstrueif this collection contains the specified element.This implementation iterates over the elements in the collection, looking for the specified element.
- Specified by:
containsin interfaceIntCollection- 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 theListinterface forces us to use a distinguished name. For simplicity, the set interfaces reinstatesremove().This implementation iterates over the elements in the collection, looking for the specified element and tries to remove it.
- Specified by:
remin interfaceIntCollection- See Also:
Collection.remove(Object)
-
add
@Deprecated public boolean add(Integer key)
Deprecated.Please use the corresponding type-specific method instead.- Specified by:
addin interfaceCollection<Integer>- Specified by:
addin interfaceIntCollection- Overrides:
addin classAbstractCollection<Integer>
-
contains
@Deprecated public boolean contains(Object key)
Deprecated.Please use the corresponding type-specific method instead.- Specified by:
containsin interfaceCollection<Integer>- Specified by:
containsin interfaceIntCollection- Overrides:
containsin classAbstractCollection<Integer>
-
remove
@Deprecated public boolean remove(Object key)
Deprecated.Please use the corresponding type-specific method instead.- Specified by:
removein interfaceCollection<Integer>- Specified by:
removein interfaceIntCollection- Overrides:
removein classAbstractCollection<Integer>
-
toArray
public int[] toArray(int[] a)
Description copied from interface:IntCollectionReturns 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:
toArrayin interfaceIntCollection- 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:IntCollectionReturns a primitive type array containing the items of this collection.- Specified by:
toIntArrayin interfaceIntCollection- Returns:
- a primitive type array containing the items of this collection.
- See Also:
Collection.toArray()
-
toIntArray
@Deprecated public int[] toIntArray(int[] a)
Deprecated.Please usetoArray()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:
toIntArrayin interfaceIntCollection- 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:IntCollectionAdds all elements of the given type-specific collection to this collection.- Specified by:
addAllin interfaceIntCollection- Parameters:
c- a type-specific collection.- Returns:
trueif this collection changed as a result of the call.- See Also:
Collection.addAll(Collection)
-
addAll
public boolean addAll(Collection<? extends Integer> c)
This implementation delegates to the type-specific version if given a type-specific collection, otherwise is uses the implementation from
AbstractCollection.- Specified by:
addAllin interfaceCollection<Integer>- Overrides:
addAllin classAbstractCollection<Integer>
-
containsAll
public boolean containsAll(IntCollection c)
Description copied from interface:IntCollectionChecks whether this collection contains all elements from the given type-specific collection.- Specified by:
containsAllin interfaceIntCollection- Parameters:
c- a type-specific collection.- Returns:
trueif this collection contains all elements of the argument.- See Also:
Collection.containsAll(Collection)
-
containsAll
public boolean containsAll(Collection<?> c)
This implementation delegates to the type-specific version if given a type-specific collection, otherwise is uses the implementation from
AbstractCollection.- Specified by:
containsAllin interfaceCollection<Integer>- Overrides:
containsAllin classAbstractCollection<Integer>
-
removeAll
public boolean removeAll(IntCollection c)
Description copied from interface:IntCollectionRemove from this collection all elements in the given type-specific collection.- Specified by:
removeAllin interfaceIntCollection- Parameters:
c- a type-specific collection.- Returns:
trueif this collection changed as a result of the call.- See Also:
Collection.removeAll(Collection)
-
removeAll
public boolean removeAll(Collection<?> c)
This implementation delegates to the type-specific version if given a type-specific collection, otherwise is uses the implementation from
AbstractCollection.- Specified by:
removeAllin interfaceCollection<Integer>- Overrides:
removeAllin classAbstractCollection<Integer>
-
retainAll
public boolean retainAll(IntCollection c)
Description copied from interface:IntCollectionRetains in this collection only elements from the given type-specific collection.- Specified by:
retainAllin interfaceIntCollection- Parameters:
c- a type-specific collection.- Returns:
trueif this collection changed as a result of the call.- See Also:
Collection.retainAll(Collection)
-
retainAll
public boolean retainAll(Collection<?> c)
This implementation delegates to the type-specific version if given a type-specific collection, otherwise is uses the implementation from
AbstractCollection.- Specified by:
retainAllin interfaceCollection<Integer>- Overrides:
retainAllin classAbstractCollection<Integer>
-
toString
public String toString()
- Overrides:
toStringin classAbstractCollection<Integer>
-
-