zombie.util.list
Class AbstractIntList

java.lang.Object
  zombie.util.AbstractIntCollection
      zombie.util.list.AbstractIntList

All Implemented Interfaces:

IntCollection, IntList

Direct Known Subclasses:

IntArrayList

public abstract class AbstractIntList
extends AbstractIntCollection
implements IntList

This class represents an abstract base for implementing lists of int 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

Version:

1.2 21-08-2003 19:14

Author:

Søren Bak

Method Summary

boolean	add(int v) Throws UnsupportedOperationException.
void	add(int index, int v) Throws UnsupportedOperationException.
boolean	addAll(int index, IntCollection c) Adds all the elements of a specified collection to this list starting at a specified index.
boolean	equals(java.lang.Object obj) Indicates whether this collection is equal to some object.
int	hashCode() Returns a hash code value for this collection.
int	indexOf(int c) Returns the index of the first occurance of a specified element in this list.
int	indexOf(int index, int c) Returns the index of the first occurance of a specified element in this list after or at a specified index.
IntIterator	iterator() Returns an iterator over this collection.
int	lastIndexOf(int c) Returns the index of the last occurance of a specified element in this list.
int	lastIndexOf(int index, int c) Returns the index of the last occurance of a specified element in this list before a specified index.
IntListIterator	listIterator() Returns a list iterator over this list.
IntListIterator	listIterator(int index) Returns a list iterator over this list, starting from a specified index.
int	removeElementAt(int index) Throws UnsupportedOperationException.

Methods inherited from class zombie.util.AbstractIntCollection

addAll, clear, contains, containsAll, isEmpty, remove, removeAll, retainAll, size, toArray, toArray, toString, trimToSize

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface zombie.util.list.IntList

get, set

Methods inherited from interface zombie.util.IntCollection

addAll, clear, contains, containsAll, isEmpty, remove, removeAll, retainAll, size, toArray, toArray, trimToSize

Method Detail

add

public boolean add(int v)

Description copied from class: AbstractIntCollection

Throws UnsupportedOperationException.

Specified by:

add in interface IntCollection

Overrides:

add in class AbstractIntCollection

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.

See Also:

IntCollection.addAll(IntCollection)

add

public void add(int index,
                int v)

Throws UnsupportedOperationException.

Specified by:

add in interface IntList

Parameters:

index - the index at which to add the element. If index == size() the element is appended to this list.

v - the int value to add to this list.

Throws:

java.lang.UnsupportedOperationException - unconditionally.

See Also:

IntCollection.add(int), IntCollection.addAll(IntCollection), IntList.addAll(int,IntCollection)

addAll

public boolean addAll(int index,
                      IntCollection c)

Description copied from interface: IntList

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 IntList

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:

IntCollection.add(int), IntList.add(int, int), IntCollection.addAll(IntCollection)

indexOf

public int indexOf(int c)

Description copied from interface: IntList

Returns the index of the first occurance of a specified element in this list.

Specified by:

indexOf in interface IntList

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,
                   int c)

Description copied from interface: IntList

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 IntList

Parameters:

index - the index at which to start the search.

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.

Since:

1.2

iterator

public IntIterator iterator()

Description copied from interface: IntCollection

Returns an iterator over this collection.

Specified by:

iterator in interface IntCollection

Returns:

an iterator over this collection.

lastIndexOf

public int lastIndexOf(int c)

Description copied from interface: IntList

Returns the index of the last occurance of a specified element in this list.

Specified by:

lastIndexOf in interface IntList

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,
                       int c)

Description copied from interface: IntList

Returns the index of the last occurance of a specified element in this list before a specified index.

Specified by:

lastIndexOf in interface IntList

Parameters:

index - the index at which to start the search. Note that the element at index is not included in the search.

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.

listIterator

public IntListIterator listIterator()

Description copied from interface: IntList

Returns a list iterator over this list.

Specified by:

listIterator in interface IntList

Returns:

a list iterator over this list.

listIterator

public IntListIterator listIterator(int index)

Description copied from interface: IntList

Returns a list iterator over this list, starting from a specified index.

Specified by:

listIterator in interface IntList

Parameters:

index - the index at which to begin the iteration.

Returns:

a list iterator over this list.

removeElementAt

public int removeElementAt(int index)

Throws UnsupportedOperationException.

Specified by:

removeElementAt in interface IntList

Parameters:

index - the index of the element to remove.

Returns:

the value of the element removed.

Throws:

java.lang.UnsupportedOperationException - unconditionally.

equals

public boolean equals(java.lang.Object obj)

Description copied from interface: IntCollection

Indicates whether this collection is equal to some object.

Specified by:

equals in interface IntCollection

Overrides:

equals in class java.lang.Object

Parameters:

obj - the object with which to compare this collection.

Returns:

true if this collection is equals to obj; returns false otherwise.

hashCode

public int hashCode()

Description copied from interface: IntCollection

Returns a hash code value for this collection.

Specified by:

hashCode in interface IntCollection

Overrides:

hashCode in class java.lang.Object

Returns:

a hash code value for this collection.