it.unimi.dsi.fastutil.longs
Class AbstractLongCollection

java.lang.Object
  extended by java.util.AbstractCollection<java.lang.Long>
      extended by it.unimi.dsi.fastutil.longs.AbstractLongCollection
All Implemented Interfaces:
LongCollection, LongIterable, java.lang.Iterable<java.lang.Long>, java.util.Collection<java.lang.Long>
Direct Known Subclasses:
AbstractLongBigList, AbstractLongList, AbstractLongSet, LongCollections.EmptyCollection, LongCollections.IterableCollection

public abstract class AbstractLongCollection
extends java.util.AbstractCollection<java.lang.Long>
implements LongCollection

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.


Method Summary
 boolean add(long k)
           
 boolean add(java.lang.Long o)
          Delegates to the corresponding type-specific method.
 boolean addAll(java.util.Collection<? extends java.lang.Long> c)
          Adds all elements of the given collection to this collection.
 boolean addAll(LongCollection c)
          Adds all elements of the given type-specific collection to this collection.
 boolean contains(long k)
           
 boolean contains(java.lang.Object o)
          Delegates to the corresponding type-specific method.
 boolean containsAll(java.util.Collection<?> c)
          Checks whether this collection contains all elements from the given collection.
 boolean containsAll(LongCollection c)
          Checks whether this collection contains all elements from the given type-specific collection.
 boolean isEmpty()
           
abstract  LongIterator iterator()
          Returns a type-specific iterator on the elements of this collection.
 LongIterator longIterator()
          Deprecated. 
 boolean rem(long k)
          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.
 boolean rem(java.lang.Object o)
          Delegates to the corresponding type-specific method.
 boolean remove(java.lang.Object ok)
          Delegates to the type-specific rem() method.
 boolean removeAll(java.util.Collection<?> c)
          Remove from this collection all elements in the given collection.
 boolean removeAll(LongCollection c)
          Remove from this collection all elements in the given type-specific collection.
 boolean retainAll(java.util.Collection<?> c)
          Retains in this collection only elements from the given collection.
 boolean retainAll(LongCollection c)
          Retains in this collection only elements from the given type-specific collection.
 java.lang.Object[] toArray()
           
 long[] toArray(long[] a)
          Returns a primitive type array containing the items of this collection.
<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.
 long[] toLongArray()
          Returns a primitive type array containing the items of this collection.
 long[] toLongArray(long[] a)
          Returns a primitive type array containing the items of this collection.
 java.lang.String toString()
           
 
Methods inherited from class java.util.AbstractCollection
clear, size
 
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, size
 

Method Detail

toArray

public long[] toArray(long[] a)
Description copied from interface: LongCollection
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:
toArray in interface LongCollection
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[])

toLongArray

public long[] toLongArray()
Description copied from interface: LongCollection
Returns a primitive type array containing the items of this collection.

Specified by:
toLongArray in interface LongCollection
Returns:
a primitive type array containing the items of this collection.
See Also:
Collection.toArray()

toLongArray

public long[] toLongArray(long[] a)
Description copied from interface: LongCollection
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:
toLongArray in interface LongCollection
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(LongCollection c)
Adds all elements of the given type-specific collection to this collection.

Specified by:
addAll in interface LongCollection
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(LongCollection c)
Checks whether this collection contains all elements from the given type-specific collection.

Specified by:
containsAll in interface LongCollection
Parameters:
c - a type-specific collection.
Returns:
true if this collection contains all elements of the argument.
See Also:
Collection.containsAll(Collection)

retainAll

public boolean retainAll(LongCollection c)
Retains in this collection only elements from the given type-specific collection.

Specified by:
retainAll in interface LongCollection
Parameters:
c - a type-specific collection.
Returns:
true if this collection changed as a result of the call.
See Also:
Collection.retainAll(Collection)

removeAll

public boolean removeAll(LongCollection c)
Remove from this collection all elements in the given type-specific collection.

Specified by:
removeAll in interface LongCollection
Parameters:
c - a type-specific collection.
Returns:
true if this collection changed as a result of the call.
See Also:
Collection.removeAll(Collection)

toArray

public java.lang.Object[] toArray()
Specified by:
toArray in interface java.util.Collection<java.lang.Long>
Overrides:
toArray in class java.util.AbstractCollection<java.lang.Long>

toArray

public <T> T[] toArray(T[] a)
Description copied from interface: LongCollection
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 LongCollection
Specified by:
toArray in interface java.util.Collection<java.lang.Long>
Overrides:
toArray in class java.util.AbstractCollection<java.lang.Long>
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(java.util.Collection<? extends java.lang.Long> c)
Adds all elements of the given collection to this collection.

Specified by:
addAll in interface java.util.Collection<java.lang.Long>
Overrides:
addAll in class java.util.AbstractCollection<java.lang.Long>
Parameters:
c - a collection.
Returns:
true if this collection changed as a result of the call.

add

public boolean add(long k)
Specified by:
add in interface LongCollection
See Also:
Collection.add(Object)

longIterator

@Deprecated
public LongIterator longIterator()
Deprecated. 

Delegates to the new covariantly stronger generic method.

Specified by:
longIterator in interface LongCollection
See Also:
LongCollection.iterator()

iterator

public abstract LongIterator iterator()
Description copied from interface: LongCollection
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 LongCollection
Specified by:
iterator in interface LongIterable
Specified by:
iterator in interface java.lang.Iterable<java.lang.Long>
Specified by:
iterator in interface java.util.Collection<java.lang.Long>
Specified by:
iterator in class java.util.AbstractCollection<java.lang.Long>
Returns:
a type-specific iterator on the elements of this collection.

remove

public boolean remove(java.lang.Object ok)
Delegates to the type-specific rem() method.

Specified by:
remove in interface java.util.Collection<java.lang.Long>
Overrides:
remove in class java.util.AbstractCollection<java.lang.Long>

add

public boolean add(java.lang.Long o)
Delegates to the corresponding type-specific method.

Specified by:
add in interface java.util.Collection<java.lang.Long>
Overrides:
add in class java.util.AbstractCollection<java.lang.Long>

rem

public boolean rem(java.lang.Object o)
Delegates to the corresponding type-specific method.


contains

public boolean contains(java.lang.Object o)
Delegates to the corresponding type-specific method.

Specified by:
contains in interface java.util.Collection<java.lang.Long>
Overrides:
contains in class java.util.AbstractCollection<java.lang.Long>

contains

public boolean contains(long k)
Specified by:
contains in interface LongCollection
See Also:
Collection.contains(Object)

rem

public boolean rem(long k)
Description copied from interface: LongCollection
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().

Specified by:
rem in interface LongCollection
See Also:
Collection.remove(Object)

containsAll

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

Specified by:
containsAll in interface java.util.Collection<java.lang.Long>
Overrides:
containsAll in class java.util.AbstractCollection<java.lang.Long>
Parameters:
c - a collection.
Returns:
true if this collection contains all elements of the argument.

retainAll

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

Specified by:
retainAll in interface java.util.Collection<java.lang.Long>
Overrides:
retainAll in class java.util.AbstractCollection<java.lang.Long>
Parameters:
c - a collection.
Returns:
true if this collection changed as a result of the call.

removeAll

public boolean removeAll(java.util.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 java.util.Collection<java.lang.Long>
Overrides:
removeAll in class java.util.AbstractCollection<java.lang.Long>
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 java.util.Collection<java.lang.Long>
Overrides:
isEmpty in class java.util.AbstractCollection<java.lang.Long>

toString

public java.lang.String toString()
Overrides:
toString in class java.util.AbstractCollection<java.lang.Long>