org.aoju.bus.core.collection

Class ArrayIterator<E>

java.lang.Object

org.aoju.bus.core.collection.ArrayIterator<E>

Type Parameters:

E - 元素类型

All Implemented Interfaces:

Iterator<E>, ResettableIterator<E>

public class ArrayIterator<E>
extends Object
implements ResettableIterator<E>

实现一个Iterator 任何数组的迭代器 数组可以是对象数组,也可以是基元数组 如果你知道 class是更好的选择,因为它会表现得更好 迭代器实现了一个reset()方法,允许重置 如果需要,迭代器返回到开始

Since:

JDK 1.8+

Version:

5.2.8

Author:

Kimi Liu

Constructor Summary

Constructors

Constructor and Description
ArrayIterator(Object array) Constructs an ArrayIterator that will iterate over the values in the specified array.
ArrayIterator(Object array, int startIndex) Constructs an ArrayIterator that will iterate over the values in the specified array from a specific start index.
ArrayIterator(Object array, int startIndex, int endIndex) Construct an ArrayIterator that will iterate over a range of values in the specified array.

Method Summary

Modifier and Type	Method and Description
protected void	checkBound(int bound, int len, String type) Checks whether the index is valid or not.
Object	getArray() Gets the array that this iterator is iterating over.
int	getEndIndex() Gets the end index to loop to.
int	getStartIndex() Gets the start index to loop from.
boolean	hasNext() Returns true if there are more elements to return from the array.
E	next() Returns the next element in the array.
void	remove() Throws UnsupportedOperationException.
void	reset() Resets the iterator back to the start index.

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

Constructor Detail

ArrayIterator

public ArrayIterator(Object array)

Constructs an ArrayIterator that will iterate over the values in the specified array.

Parameters:

array - the array to iterate over.

Throws:

IllegalArgumentException - if array is not an array.

NullPointerException - if array is null

ArrayIterator

public ArrayIterator(Object array,
                     int startIndex)

Constructs an ArrayIterator that will iterate over the values in the specified array from a specific start index.

Parameters:

array - the array to iterate over.

startIndex - the index to start iterating at.

Throws:

IllegalArgumentException - if array is not an array.

NullPointerException - if array is null

IndexOutOfBoundsException - if the index is invalid

ArrayIterator

public ArrayIterator(Object array,
                     int startIndex,
                     int endIndex)

Construct an ArrayIterator that will iterate over a range of values in the specified array.

Parameters:

array - the array to iterate over.

startIndex - the index to start iterating at.

endIndex - the index to finish iterating at.

Throws:

IllegalArgumentException - if array is not an array.

NullPointerException - if array is null

IndexOutOfBoundsException - if either index is invalid

Method Detail

checkBound

protected void checkBound(int bound,
                          int len,
                          String type)

Checks whether the index is valid or not.

Parameters:

bound - the index to check

len - the length of the array

type - the index type (for error messages)

Throws:

IndexOutOfBoundsException - if the index is invalid

hasNext

public boolean hasNext()

Returns true if there are more elements to return from the array.

Specified by:

hasNext in interface Iterator<E>

Returns:

true if there is a next element to return

next

public E next()

Returns the next element in the array.

Specified by:

next in interface Iterator<E>

Returns:

the next element in the array

Throws:

NoSuchElementException - if all the elements in the array have already been returned

remove

public void remove()

Throws UnsupportedOperationException.

Specified by:

remove in interface Iterator<E>

Throws:

UnsupportedOperationException - always

getArray

public Object getArray()

Gets the array that this iterator is iterating over.

Returns:

the array this iterator iterates over.

getStartIndex

public int getStartIndex()

Gets the start index to loop from.

Returns:

the start index

getEndIndex

public int getEndIndex()

Gets the end index to loop to.

Returns:

the end index

reset

public void reset()

Resets the iterator back to the start index.

Specified by:

reset in interface ResettableIterator<E>