org.joda.primitives.iterator.impl

Class ArrayByteIterator

java.lang.Object

org.joda.primitives.iterator.impl.ArrayByteIterator

All Implemented Interfaces:

Iterator<Byte>, ByteIterator, PrimitiveIterator<Byte>

public class ArrayByteIterator
extends Object
implements ByteIterator

An iterator over an array of byte values.

This class implements Iterator allowing seamless integration with other APIs.

The iterator can be reset to the start if required. It is unmodifiable and remove() is unsupported.

Since:

1.0

Version:

CODE GENERATED

Author:

Stephen Colebourne, Jason Tiscione

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	array The array to iterate over
protected int	cursor Cursor position

Constructor Summary

Constructors

Constructor and Description
ArrayByteIterator(byte[] array) Constructs an iterator over an array of byte values.

Method Summary

Methods

Modifier and Type	Method and Description
static ArrayByteIterator	copyOf(byte[] array) Creates an iterator over a copy of an array of byte values.
boolean	hasNext()
boolean	isModifiable() Checks whether the iterator can currently be modified.
boolean	isResettable() Checks whether the iterator can be reset.
Byte	next()
byte	nextByte() Gets the next value from the iterator
void	remove()
void	reset() Resets the iterator back to its initial state (optional operation).

Methods inherited from class java.lang.Object

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

Field Detail

array

protected final byte[] array

The array to iterate over

cursor

protected int cursor

Cursor position

Constructor Detail

ArrayByteIterator

public ArrayByteIterator(byte[] array)

Constructs an iterator over an array of byte 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 ArrayByteIterator copyOf(byte[] array)

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

The specified array is copied, making this class effectively immutable. Note that the class is not final thus it is not truly immutable.

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<Byte>

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<Byte>

Returns:

true if the object can be reset

hasNext

public boolean hasNext()

Specified by:

hasNext in interface Iterator<Byte>

nextByte

public byte nextByte()

Description copied from interface: ByteIterator

Gets the next value from the iterator

Specified by:

nextByte in interface ByteIterator

Returns:

the next available value

next

public Byte next()

Specified by:

next in interface Iterator<Byte>

remove

public void remove()

Specified by:

remove in interface Iterator<Byte>

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<Byte>