public abstract class AbstractSequentialList<E>

  1. Object
  2. AbstractCollection<E>
  3. AbstractList<E>
  4. AbstractSequentialList

ImplementsCollection<E>, Iterable<E>, List<E>

Known subtypesLinkedList

AbstractSequentialList is an abstract implementation of the List interface. This implementation does not support adding. A subclass must implement the abstract method listIterator().

Constructors

protected AbstractSequentialList()Constructs a new instance of this AbstractSequentialList.

Methods

public void add(int location, E object)Inserts the specified object into this List at the specified location.
public boolean addAll(int location, Collection<? extends E> collection)Inserts the objects in the specified Collection at the specified location in this List.
public E get(int location)Returns the element at the specified location in this list.
public Iterator<E> iterator()Returns an iterator on the elements of this list.
public abstract ListIterator<E> listIterator(int location)Returns a list iterator on the elements of this list.
public E remove(int location)Removes the object at the specified location from this list.
public E set(int location, E object)Replaces the element at the specified location in this list with the specified object.

Inherited fields

Inherited methods

Constructor details

AbstractSequentialList

protected AbstractSequentialList()
Constructs a new instance of this AbstractSequentialList.

Method details

add

public void add(int location, E object)

Inserts the specified object into this List at the specified location. The object is inserted before any previous element at the specified location. If the location is equal to the size of this List, the object is added at the end.

Concrete implementations that would like to support the add functionality must override this method.

Parameters

location int
the index at which to insert.
object E
the object to add.

Throws

UnsupportedOperationException
if adding to this List is not supported.
ClassCastException
if the class of the object is inappropriate for this List
IllegalArgumentException
if the object cannot be added to this List
IndexOutOfBoundsException
if location = size()

addAll

public boolean addAll(int location, Collection<? extends E> collection)
Inserts the objects in the specified Collection at the specified location in this List. The objects are added in the order they are returned from the collection’s iterator.

Parameters

location int
the index at which to insert.
collection Collection<? extends E>
the Collection of objects

Returns

true if this List is modified, false otherwise.

Throws

UnsupportedOperationException
if adding to this list is not supported.
ClassCastException
if the class of an object is inappropriate for this list.
IllegalArgumentException
if an object cannot be added to this list.
IndexOutOfBoundsException
if location size()

get

public E get(int location)
Returns the element at the specified location in this list.

Parameters

location int
the index of the element to return.

Returns

the element at the specified index.

Throws

IndexOutOfBoundsException
if location = size()

iterator

public Iterator<E> iterator()
Returns an iterator on the elements of this list. The elements are iterated in the same order as they occur in the list.

Returns

an iterator on the elements of this list.

See also

listIterator

public abstract ListIterator<E> listIterator(int location)
Returns a list iterator on the elements of this list. The elements are iterated in the same order as they occur in the list. The iteration starts at the specified location.

Parameters

location int
the index at which to start the iteration.

Returns

a ListIterator on the elements of this list.

Throws

IndexOutOfBoundsException
if location size()

See also

remove

public E remove(int location)
Removes the object at the specified location from this list.

Parameters

location int
the index of the object to remove.

Returns

the removed object.

Throws

UnsupportedOperationException
if removing from this list is not supported.
IndexOutOfBoundsException
if location = size()

set

public E set(int location, E object)
Replaces the element at the specified location in this list with the specified object.

Parameters

location int
the index at which to put the specified object.
object E
the object to add.

Returns

the previous element at the index.

Throws

UnsupportedOperationException
if replacing elements in this list is not supported.
ClassCastException
if the class of an object is inappropriate for this list.
IllegalArgumentException
if an object cannot be added to this list.
IndexOutOfBoundsException
if location = size()