PCJ API
Version 1.2

bak.pcj.list
Class AbstractByteList

java.lang.Object
  extended bybak.pcj.AbstractByteCollection
      extended bybak.pcj.list.AbstractByteList
All Implemented Interfaces:
ByteCollection, ByteList
Direct Known Subclasses:
ByteArrayDeque, ByteArrayList, ListToByteListAdapter

public abstract class AbstractByteList
extends AbstractByteCollection
implements ByteList

This class represents an abstract base for implementing lists of byte values. All operations that can be implemented using iterators and the get() and set() methods are implemented as such. In most cases, this is hardly an efficient solution, and at least some of those methods should be overridden by sub-classes.

Since:
1.0

Constructor Summary
protected AbstractByteList()
          Default constructor to be invoked by sub-classes.
 
Method Summary
 boolean add(byte v)
          Adds an element to this collection.
 void add(int index, byte v)
          Throws UnsupportedOperationException.
 boolean addAll(int index, ByteCollection c)
          Adds all the elements of a specified collection to this list starting at a specified index.
 boolean equals(Object obj)
          Indicates whether this collection is equal to some object.
 int hashCode()
          Returns a hash code value for this collection.
 int indexOf(byte c)
          Returns the index of the first occurance of a specified element in this list.
 int indexOf(int index, byte c)
          Returns the index of the first occurance of a specified element in this list after or at a specified index.
 ByteIterator iterator()
          Returns an iterator over this collection.
 int lastIndexOf(byte c)
          Returns the index of the last occurance of a specified element in this list.
 int lastIndexOf(int index, byte c)
          Returns the index of the last occurance of a specified element in this list before a specified index.
 ByteListIterator listIterator()
          Returns a list iterator over this list.
 ByteListIterator listIterator(int index)
          Returns a list iterator over this list, starting from a specified index.
 byte removeElementAt(int index)
          Throws UnsupportedOperationException.
 
Methods inherited from class bak.pcj.AbstractByteCollection
addAll, clear, contains, containsAll, isEmpty, remove, removeAll, retainAll, size, toArray, toArray, toString, trimToSize
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface bak.pcj.list.ByteList
get, set
 
Methods inherited from interface bak.pcj.ByteCollection
addAll, clear, contains, containsAll, isEmpty, remove, removeAll, retainAll, size, toArray, toArray, trimToSize
 

Constructor Detail

AbstractByteList

protected AbstractByteList()
Default constructor to be invoked by sub-classes.

Method Detail

add

public boolean add(byte v)
Description copied from interface: ByteCollection
Adds an element to this collection.

Specified by:
add in interface ByteCollection
Overrides:
add in class AbstractByteCollection

add

public void add(int index,
                byte v)
Throws UnsupportedOperationException.

Specified by:
add in interface ByteList
Parameters:
index - the index at which to add the element. If index == size() the element is appended to this list.
v - the byte value to add to this list.
Throws:
UnsupportedOperationException - unconditionally.
See Also:
ByteCollection.add(byte), ByteCollection.addAll(ByteCollection), ByteList.addAll(int,ByteCollection)

addAll

public boolean addAll(int index,
                      ByteCollection c)
Description copied from interface: ByteList
Adds all the elements of a specified collection to this list starting at a specified index. The elements are inserted in the specified collection's iteration order. All elements from the specified index and forward are pushed to their successors' indices (c.size() indices).

Specified by:
addAll in interface ByteList
Parameters:
index - the index at which to insert the elements of the specified collection. If index == size() the elements are appended to this list.
c - the collection whose elements to add to this list.
Returns:
true if this list was modified as a result of adding the elements of c; returns false otherwise.
See Also:
ByteCollection.add(byte), ByteList.add(int, byte), ByteCollection.addAll(ByteCollection)

indexOf

public int indexOf(byte c)
Description copied from interface: ByteList
Returns the index of the first occurance of a specified element in this list.

Specified by:
indexOf in interface ByteList
Parameters:
c - the element to find.
Returns:
the index of the first occurance of the specified element in this list; returns -1, if the element is not contained in this list.

indexOf

public int indexOf(int index,
                   byte c)
Description copied from interface: ByteList
Returns the index of the first occurance of a specified element in this list after or at a specified index.

Specified by:
indexOf in interface ByteList
Parameters:
c - the element to find.
index - the index at which to start the search.
Returns:
the index of the first occurance of the specified element in this list; returns -1, if the element is not contained in this list.
Since:
1.2

iterator

public ByteIterator iterator()
Description copied from interface: ByteCollection
Returns an iterator over this collection.

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

lastIndexOf

public int lastIndexOf(byte c)
Description copied from interface: ByteList
Returns the index of the last occurance of a specified element in this list.

Specified by:
lastIndexOf in interface ByteList
Parameters:
c - the element to find.
Returns:
the index of the last occurance of the specified element in this list; returns -1, if the element is not contained in this list.

lastIndexOf

public int lastIndexOf(int index,
                       byte c)
Description copied from interface: ByteList
Returns the index of the last occurance of a specified element in this list before a specified index.

Specified by:
lastIndexOf in interface ByteList
Parameters:
c - the element to find.
index - the index at which to start the search. Note that the element at index is not included in the search.
Returns:
the index of the last occurance of the specified element in this list; returns -1, if the element is not contained in this list.

listIterator

public ByteListIterator listIterator()
Description copied from interface: ByteList
Returns a list iterator over this list.

Specified by:
listIterator in interface ByteList
Returns:
a list iterator over this list.

listIterator

public ByteListIterator listIterator(int index)
Description copied from interface: ByteList
Returns a list iterator over this list, starting from a specified index.

Specified by:
listIterator in interface ByteList
Parameters:
index - the index at which to begin the iteration.
Returns:
a list iterator over this list.

removeElementAt

public byte removeElementAt(int index)
Throws UnsupportedOperationException.

Specified by:
removeElementAt in interface ByteList
Parameters:
index - the index of the element to remove.
Returns:
the value of the element removed.
Throws:
UnsupportedOperationException - unconditionally.

equals

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

Specified by:
equals in interface ByteCollection

hashCode

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

Specified by:
hashCode in interface ByteCollection

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