PCJ API
Version 1.2

bak.pcj
Class UnmodifiableLongCollection

java.lang.Object
  extended bybak.pcj.UnmodifiableLongCollection
All Implemented Interfaces:
LongCollection
Direct Known Subclasses:
UnmodifiableLongList, UnmodifiableLongSet

public class UnmodifiableLongCollection
extends Object
implements LongCollection

This class represents unmodifiable collections of long values.

Since:
1.0
See Also:
Collections.unmodifiableCollection(java.util.Collection)

Field Summary
protected  LongCollection collection
          The collection underlying this unmodifiable collection.
 
Constructor Summary
UnmodifiableLongCollection(LongCollection c)
          Creates a new unmodifiable collection on an existing collection.
 
Method Summary
 boolean add(long v)
          Throws UnsupportedOperationException.
 boolean addAll(LongCollection c)
          Throws UnsupportedOperationException.
 void clear()
          Throws UnsupportedOperationException.
 boolean contains(long v)
          Indicates whether this collection contains a specified element.
 boolean containsAll(LongCollection c)
          Indicates whether all elements of a specified collection is contained in this collection.
 boolean equals(Object obj)
          Indicates whether this collection is equal to some object.
 int hashCode()
          Returns a hash code value for this collection.
 boolean isEmpty()
          Indicates whether this collection is empty.
 LongIterator iterator()
          Returns an iterator over this collection.
 boolean remove(long v)
          Throws UnsupportedOperationException.
 boolean removeAll(LongCollection c)
          Throws UnsupportedOperationException.
 boolean retainAll(LongCollection c)
          Throws UnsupportedOperationException.
 int size()
          Returns the number of elements in this collection.
 long[] toArray()
          Returns the elements of this collection as an array.
 long[] toArray(long[] a)
          Returns the elements of this collection as an array.
 void trimToSize()
          Minimizes the memory used by this collection.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

collection

protected LongCollection collection
The collection underlying this unmodifiable collection.

Constructor Detail

UnmodifiableLongCollection

public UnmodifiableLongCollection(LongCollection c)
Creates a new unmodifiable collection on an existing collection. The result is a collection whose elements and behaviour is the same as the existing collection's except that the new collection cannot be modified.

Parameters:
c - the existing collection to make unmodifiable.
Throws:
NullPointerException - if c is null.
Method Detail

add

public boolean add(long v)
Throws UnsupportedOperationException.

Specified by:
add in interface LongCollection
Parameters:
v - the element to add to this collection.
Returns:
true if this collection was modified as a result of adding v; returns false otherwise.
Throws:
UnsupportedOperationException - unconditionally.
See Also:
LongCollection.addAll(LongCollection)

addAll

public boolean addAll(LongCollection c)
Throws UnsupportedOperationException.

Specified by:
addAll in interface LongCollection
Parameters:
c - the collection whose elements to add to this collection.
Returns:
true if this collection was modified as a result of adding the elements of c; returns false otherwise.
Throws:
UnsupportedOperationException - unconditionally.
See Also:
LongCollection.add(long)

clear

public void clear()
Throws UnsupportedOperationException.

Specified by:
clear in interface LongCollection
Throws:
UnsupportedOperationException - unconditionally.

contains

public boolean contains(long v)
Description copied from interface: LongCollection
Indicates whether this collection contains a specified element.

Specified by:
contains in interface LongCollection
Parameters:
v - the element to test for containment.
Returns:
true if v is contained in this collection; returns false otherwise.
See Also:
LongCollection.containsAll(LongCollection)

containsAll

public boolean containsAll(LongCollection c)
Description copied from interface: LongCollection
Indicates whether all elements of a specified collection is contained in this collection.

Specified by:
containsAll in interface LongCollection
Parameters:
c - the collection whose elements to test for containment.
Returns:
true if all the elements of c are contained in this collection; returns false otherwise.
See Also:
LongCollection.contains(long)

equals

public boolean equals(Object obj)
Description copied from interface: LongCollection
Indicates whether this collection is equal to some object.

Specified by:
equals in interface LongCollection

hashCode

public int hashCode()
Description copied from interface: LongCollection
Returns a hash code value for this collection.

Specified by:
hashCode in interface LongCollection

isEmpty

public boolean isEmpty()
Description copied from interface: LongCollection
Indicates whether this collection is empty.

Specified by:
isEmpty in interface LongCollection
Returns:
true if this collection is empty; returns false otherwise.

iterator

public LongIterator iterator()
Description copied from interface: LongCollection
Returns an iterator over this collection.

Specified by:
iterator in interface LongCollection
Returns:
an iterator over this collection.

remove

public boolean remove(long v)
Throws UnsupportedOperationException.

Specified by:
remove in interface LongCollection
Parameters:
v - the long value to remove from this collection.
Returns:
true if this collection was modified as a result of removing v; returns false otherwise.
Throws:
UnsupportedOperationException - unconditionally.

removeAll

public boolean removeAll(LongCollection c)
Throws UnsupportedOperationException.

Specified by:
removeAll in interface LongCollection
Parameters:
c - the collection whose elements to remove from this collection.
Returns:
true if this collection was modified as a result of removing the elements of c; returns false otherwise.
Throws:
UnsupportedOperationException - unconditionally.

retainAll

public boolean retainAll(LongCollection c)
Throws UnsupportedOperationException.

Specified by:
retainAll in interface LongCollection
Parameters:
c - the collection whose elements to retain in this collection.
Returns:
true if this collection was modified as a result of removing the elements not contained in c; returns false otherwise.
Throws:
UnsupportedOperationException - unconditionally.

size

public int size()
Description copied from interface: LongCollection
Returns the number of elements in this collection.

Specified by:
size in interface LongCollection
Returns:
the number of elements in this collection.

toArray

public long[] toArray()
Description copied from interface: LongCollection
Returns the elements of this collection as an array.

Specified by:
toArray in interface LongCollection
Returns:
a new array containing the elements of this collection.

toArray

public long[] toArray(long[] a)
Description copied from interface: LongCollection
Returns the elements of this collection as an array.

Specified by:
toArray in interface LongCollection
Parameters:
a - an array to fill with the elements of this collection; if a is null or not big enough to contain all the elements of this collection, an new array is allocated, and a is not changed.
Returns:
a, if a has room for all the elements of this collection; otherwise a new array is allocated, filled with the elements of this collection, and returned.

trimToSize

public void trimToSize()
Description copied from interface: LongCollection
Minimizes the memory used by this collection. The exact operation of this method depends on the class implementing it. Implementors may choose to ignore it completely.

Specified by:
trimToSize in interface LongCollection

PCJ API
Version 1.2

Report a bug or request a feature.
Further information on the development and latest release of PCJ can be found at the project homepage.

Primitive Collections for Java is released under the GNU Lesser General Public License.
Copyright © 2002, 2003 Søren Bak. All Rights Reserved.

Hosted by SourceForge.net
SourceForge.net Logo