org.joda.primitives.listiterator.impl

Class ArrayLongListIterator

java.lang.Object

org.joda.primitives.listiterator.impl.ArrayLongListIterator

All Implemented Interfaces:

Iterator<Long>, ListIterator<Long>, LongIterator, PrimitiveIterator<Long>, LongListIterator, PrimitiveListIterator<Long>

public class ArrayLongListIterator
extends Object
implements LongListIterator

An iterator over an array of long values.

This class implements ListIterator allowing seamless integration with other APIs.

The iterator can be reset to the start if required. add() and remove() are unsupported, but set() is supported.

Since:

1.0

Version:

CODE GENERATED

Author:

Stephen Colebourne, Jason Tiscione

Field Summary

Fields

Modifier and Type	Field and Description
protected long[]	array The array to iterate over
protected int	cursor Cursor position
protected int	last Last returned position

Constructor Summary

Constructors

Constructor and Description
ArrayLongListIterator(long[] array) Constructs an iterator over an array of long values.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(long value) Adds the specified value to the list underlying the iterator at the current iteration index (optional operation).
void	add(Long value)
static ArrayLongListIterator	copyOf(long[] array) Creates an iterator over a copy of an array of long values.
boolean	hasNext()
boolean	hasPrevious()
boolean	isModifiable() Checks whether the iterator can currently be modified.
boolean	isResettable() Checks whether the iterator can be reset.
Long	next()
int	nextIndex()
long	nextLong() Gets the next value from the iterator
Long	previous()
int	previousIndex()
long	previousLong() Gets the previous value from the iterator.
void	remove()
void	reset() Resets the iterator back to its initial state (optional operation).
void	set(long value) Sets the last retrieved value from the iterator (optional operation).
void	set(Long value)

Methods inherited from class java.lang.Object

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

Field Detail

array

protected final long[] array

The array to iterate over

cursor

protected int cursor

Cursor position

last

protected int last

Last returned position

Constructor Detail

ArrayLongListIterator

public ArrayLongListIterator(long[] array)

Constructs an iterator over an array of long values.

The array is assigned internally, thus the caller holds a reference to the internal state of the returned iterator. It is not recommended to modify the state of the array after construction.

Parameters:

array - the array to iterate over, must not be null

Throws:

IllegalArgumentException - if the array is null

Method Detail

copyOf

public static ArrayLongListIterator copyOf(long[] array)

Creates an iterator over a copy of an array of long values.

The specified array is copied, ensuring the original data is unaltered. Note that the class is not immutable due to the set methods.

Parameters:

array - the array to iterate over, must not be null

Throws:

IllegalArgumentException - if the array is null

isModifiable

public boolean isModifiable()

Description copied from interface: PrimitiveIterator

Checks whether the iterator can currently be modified.

Specified by:

isModifiable in interface PrimitiveIterator<Long>

Returns:

true if the modification methods of the iterator can be used

isResettable

public boolean isResettable()

Description copied from interface: PrimitiveIterator

Checks whether the iterator can be reset.

Specified by:

isResettable in interface PrimitiveIterator<Long>

Returns:

true if the object can be reset

hasNext

public boolean hasNext()

Specified by:

hasNext in interface Iterator<Long>

Specified by:

hasNext in interface ListIterator<Long>

nextIndex

public int nextIndex()

Specified by:

nextIndex in interface ListIterator<Long>

nextLong

public long nextLong()

Description copied from interface: LongIterator

Gets the next value from the iterator

Specified by:

nextLong in interface LongIterator

Returns:

the next available value

next

public Long next()

Specified by:

next in interface Iterator<Long>

Specified by:

next in interface ListIterator<Long>

hasPrevious

public boolean hasPrevious()

Specified by:

hasPrevious in interface ListIterator<Long>

previousIndex

public int previousIndex()

Specified by:

previousIndex in interface ListIterator<Long>

previousLong

public long previousLong()

Description copied from interface: LongListIterator

Gets the previous value from the iterator.

Specified by:

previousLong in interface LongListIterator

Returns:

the previous available value

previous

public Long previous()

Specified by:

previous in interface ListIterator<Long>

add

public void add(long value)

Description copied from interface: LongListIterator

Adds the specified value to the list underlying the iterator at the current iteration index (optional operation).

Specified by:

add in interface LongListIterator

Parameters:

value - the value to add

add

public void add(Long value)

Specified by:

add in interface ListIterator<Long>

remove

public void remove()

Specified by:

remove in interface Iterator<Long>

Specified by:

remove in interface ListIterator<Long>

set

public void set(long value)

Description copied from interface: LongListIterator

Sets the last retrieved value from the iterator (optional operation).

Specified by:

set in interface LongListIterator

Parameters:

value - the value to set

set

public void set(Long value)

Specified by:

set in interface ListIterator<Long>

reset

public void reset()

Description copied from interface: PrimitiveIterator

Resets the iterator back to its initial state (optional operation).

Specified by:

reset in interface PrimitiveIterator<Long>