it.unimi.dsi.fastutil.objects
Class AbstractObjectCollection<K>

java.lang.Object
  extended by it.unimi.dsi.fastutil.objects.AbstractObjectCollection<K>
All Implemented Interfaces:
ObjectCollection<K>, ObjectIterable<K>, Iterable<K>, Collection<K>
Direct Known Subclasses:
AbstractObjectList, AbstractObjectSet, ObjectCollections.EmptyCollection

public abstract class AbstractObjectCollection<K>
extends Object
implements ObjectCollection<K>

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

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


Method Summary
 boolean add(K k)
           
 boolean addAll(Collection<? extends K> c)
          Adds all elements of the given collection to this collection.
 void clear()
           
 boolean containsAll(Collection<?> c)
          Checks whether this collection contains all elements from the given collection.
 boolean isEmpty()
           
abstract  ObjectIterator<K> iterator()
          Returns a type-specific iterator on the elements of this collection.
 ObjectIterator<K> objectIterator()
          Deprecated. 
 boolean remove(Object ok)
           
 boolean removeAll(Collection<?> c)
          Remove from this collection all elements in the given collection.
 boolean retainAll(Collection<?> c)
          Retains in this collection only elements from the given collection.
 Object[] toArray()
           
<T> T[]
toArray(T[] a)
          Returns an containing the items of this collection; the runtime type of the returned array is that of the specified array.
 String toString()
           
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.util.Collection
contains, equals, hashCode, size
 

Method Detail

toArray

public Object[] toArray()
Specified by:
toArray in interface Collection<K>

toArray

public <T> T[] toArray(T[] a)
Description copied from interface: ObjectCollection
Returns an containing the items of this collection; the runtime type of the returned array is that of the specified array.

Warning: 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 ObjectCollection<K>
Specified by:
toArray in interface Collection<K>
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(Collection<? extends K> c)
Adds all elements of the given collection to this collection.

Specified by:
addAll in interface Collection<K>
Parameters:
c - a collection.
Returns:
true if this collection changed as a result of the call.

add

public boolean add(K k)
Specified by:
add in interface Collection<K>

remove

public boolean remove(Object ok)
Specified by:
remove in interface Collection<K>

clear

public void clear()
Specified by:
clear in interface Collection<K>

objectIterator

@Deprecated
public ObjectIterator<K> objectIterator()
Deprecated. 

Delegates to the new covariantly stronger generic method.

Specified by:
objectIterator in interface ObjectCollection<K>
See Also:
ObjectCollection.iterator()

iterator

public abstract ObjectIterator<K> iterator()
Description copied from interface: ObjectCollection
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 ObjectCollection<K>
Specified by:
iterator in interface ObjectIterable<K>
Specified by:
iterator in interface Iterable<K>
Specified by:
iterator in interface Collection<K>
Returns:
a type-specific iterator on the elements of this collection.

containsAll

public boolean containsAll(Collection<?> c)
Checks whether this collection contains all elements from the given collection.

Specified by:
containsAll in interface Collection<K>
Parameters:
c - a collection.
Returns:
true if this collection contains all elements of the argument.

retainAll

public boolean retainAll(Collection<?> c)
Retains in this collection only elements from the given collection.

Specified by:
retainAll in interface Collection<K>
Parameters:
c - a collection.
Returns:
true if this collection changed as a result of the call.

removeAll

public boolean removeAll(Collection<?> c)
Remove from this collection all elements in the given collection. If the collection is an instance of this class, it uses faster iterators.

Specified by:
removeAll in interface Collection<K>
Parameters:
c - a collection.
Returns:
true if this collection changed as a result of the call.

isEmpty

public boolean isEmpty()
Specified by:
isEmpty in interface Collection<K>

toString

public String toString()
Overrides:
toString in class Object