java.util

インタフェース Iterator<E>

型パラメータ:

E - このイテレータで返される要素の型

既知のすべてのサブインタフェース:

ListIterator<E>, XMLEventReader

既知のすべての実装クラス:

BeanContextSupport.BCSIterator, EventReaderDelegate, Scanner

public interface Iterator<E>

コレクションのイテレータです。Iterator は、Java Collections Framework において Enumeration の代わりとなります。イテレータは、次の 2 つの点で列挙と異なります。

• イテレータを使用すると、明確なセマンティクスに基づく反復処理の間に、呼び出し側は基本となるコレクションから要素を削除できる。
• メソッド名が改良されている。

このインタフェースは、Java Collections Framework のメンバーです。

導入されたバージョン:

1.2

関連項目:

Collection, ListIterator, Iterable

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
boolean	hasNext() 反復処理でさらに要素がある場合に true を返します。
E	next() 反復処理で次の要素を返します。
void	remove() ベースとなるコレクションから、このイテレータによって最後に返された要素を削除します (オプションの操作)。

メソッドの詳細

hasNext

boolean hasNext()

反復処理でさらに要素がある場合に true を返します。つまり、next() が例外をスローするのではなく要素を返す場合は、true を返します。

戻り値:

反復処理でさらに要素がある場合は true

next

E next()

反復処理で次の要素を返します。

戻り値:

反復処理での次の要素

例外:

NoSuchElementException - 反復処理で要素がない場合

remove

void remove()

ベースとなるコレクションから、このイテレータによって最後に返された要素を削除します (オプションの操作)。このメソッドは、next() の呼び出しごとに 1 回だけ呼び出すことができます。イテレータの動作は、反復処理がこのメソッドの呼び出し以外の方法で実行されているときに基になるコレクションが変更された場合は保証されません。

例外:

UnsupportedOperationException - remove オペレーションがこのイテレータでサポートされない場合

IllegalStateException - next メソッドがまだ呼び出されてない場合、または next メソッドの最後の呼び出しのあとに remove メソッドがすでに呼び出されている場合