com.goldencode.p2j.util

Class ScopedList.NodeList.Iter

java.lang.Object

com.goldencode.p2j.util.ScopedList.NodeList.Iter

All Implemented Interfaces:

java.util.Iterator<E>, java.util.ListIterator<E>

Enclosing class:

ScopedList.NodeList

private class ScopedList.NodeList.Iter
extends java.lang.Object
implements java.util.ListIterator<E>

Implementation of a read-only list iterator for a node list. Reads only within the scope represented by the node list; nodes attached to the head and tail nodes, which are outside this scope, are ignored.

Field Summary

Fields

Modifier and Type	Field and Description
private ScopedList.Node<E>	current Node currently being iterated
private int	index Iteration cursor position

Constructor Summary

Constructors

Constructor and Description
Iter(int index) Constructor which accepts an initial cursor position.

Method Summary

Modifier and Type	Method and Description
void	add(E e) Add a new element after the current element -- unsupported in this read-only implementation.
boolean	hasNext() Indicate whether there is a next element to visit.
boolean	hasPrevious() Indicate whether there is a previous element to visit.
E	next() Return the element immediately after the current cursor position and move the cursor forward one element.
int	nextIndex() Report the index of the element immediately after the cursor's current position.
E	previous() Return the element immediately before the current cursor position and move the cursor backward one element.
int	previousIndex() Report the index of the element immediately before the cursor's current position.
void	remove() Remove the current element -- unsupported in this read-only implementation.
void	set(E e) Replace the current element -- unsupported in this read-only implementation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.Iterator

forEachRemaining

Field Detail

current

private ScopedList.Node<E> current

Node currently being iterated

index

private int index

Iteration cursor position

Constructor Detail

Iter

Iter(int index)

Constructor which accepts an initial cursor position.

Parameters:

index - Zero-based cursor position. The logical cursor is positioned before the element at this index.

Throws:

java.lang.IndexOutOfBoundsException - if index < 0 || index > size()

Method Detail

hasNext

public boolean hasNext()

Indicate whether there is a next element to visit.

Specified by:

hasNext in interface java.util.Iterator<E>

Specified by:

hasNext in interface java.util.ListIterator<E>

Returns:

true if there is a next element, else false.

next

public E next()

Return the element immediately after the current cursor position and move the cursor forward one element.

Specified by:

next in interface java.util.Iterator<E>

Specified by:

next in interface java.util.ListIterator<E>

Throws:

java.util.NoSuchElementException - if there is no available element to return.

hasPrevious

public boolean hasPrevious()

Indicate whether there is a previous element to visit.

Specified by:

hasPrevious in interface java.util.ListIterator<E>

Returns:

true if there is a previous element, else false.

previous

public E previous()

Return the element immediately before the current cursor position and move the cursor backward one element.

Specified by:

previous in interface java.util.ListIterator<E>

Throws:

java.util.NoSuchElementException - if there is no available element to return.

nextIndex

public int nextIndex()

Report the index of the element immediately after the cursor's current position. Note that this may report an invalid index beyond the last element.

Specified by:

nextIndex in interface java.util.ListIterator<E>

Returns:

Next element's index.

previousIndex

public int previousIndex()

Report the index of the element immediately before the cursor's current position. Note that this may report an invalid index beyond the first element.

Specified by:

previousIndex in interface java.util.ListIterator<E>

Returns:

Next element's index.

remove

public void remove()

Remove the current element -- unsupported in this read-only implementation.

Specified by:

remove in interface java.util.Iterator<E>

Specified by:

remove in interface java.util.ListIterator<E>

Throws:

java.lang.UnsupportedOperationException - always.

set

public void set(E e)

Replace the current element -- unsupported in this read-only implementation.

Specified by:

set in interface java.util.ListIterator<E>

Throws:

java.lang.UnsupportedOperationException - always.

add

public void add(E e)

Add a new element after the current element -- unsupported in this read-only implementation.

Specified by:

add in interface java.util.ListIterator<E>

Throws:

java.lang.UnsupportedOperationException - always.