java.util
インタフェース ListIterator
- public abstract interface ListIterator
- extends Iterator
リストのための反復子です。プログラマが、どちらかの方向にリストをたどり、反復時にリストを変更できるようにします。
- 導入されたバージョン:
- JDK1.2
- 関連項目:
Collection
,
List
,
Iterator
,
Enumeration
メソッドの概要 |
void |
add(Object o)
指定された要素をリストに挿入します (任意のオペレーション)。 |
boolean |
hasNext()
リストを順方向にたどったときに、リスト反復子がさらに要素を持っている場合に true を返します。 |
boolean |
hasPrevious()
リストを逆方向にたどったときに、リスト反復子がさらに要素を持っている場合に true を返します。 |
Object |
next()
リスト内の次の要素を返します。 |
int |
nextIndex()
次に next を呼び出したときに返されることになる要素のインデックスを返します。 |
Object |
previous()
リスト内の直前の要素を返します。 |
int |
previousIndex()
次に previous を呼び出したときに返されることになる要素のインデックスを返します。 |
void |
remove()
next または previous によって返された最後の要素をリストから削除します (任意のオペレーション)。 |
void |
set(Object o)
next または previous によって返された最後の要素を、指定された要素に置換します (任意のオペレーション)。 |
hasNext
public boolean hasNext()
- リストを順方向にたどったときに、リスト反復子がさらに要素を持っている場合に true を返します。つまり、next の呼び出しが例外をスローすることなく要素を返す場合は、true を返します。
- 定義:
- インタフェース Iterator 内の hasNext
- 戻り値:
- リストを順方向にたどったときに、リスト反復子がさらに要素を持っている場合は true
next
public Object next()
- リスト内の次の要素を返します。このメソッドは、リストを反復するために繰り返し呼び出される場合と、前後に移動するために previous の呼び出しと組み合わされる場合があります。next と previous の呼び出しを交互に行うと、繰り返し同じ要素が返されます。
- 定義:
- インタフェース Iterator 内の next
- 戻り値:
- リスト内の次の要素
- 例外:
- NoSuchElementException - 反復で次の要素がない場合
hasPrevious
public boolean hasPrevious()
- リストを逆方向にたどったときに、リスト反復子がさらに要素を持っている場合に true を返します。つまり、previous の呼び出しが例外をスローすることなく要素を返す場合は、true を返します。
- 戻り値:
- リストを逆方向にたどったときに、リスト反復子がさらに要素を持っている場合は true
previous
public Object previous()
- リスト内の直前の要素を返します。このメソッドは、リストを後方から前方に向かって反復するために繰り返し呼び出される場合と、前後に移動するために next の呼び出しと組み合わされる場合があります。next と previous の呼び出しを交互に行うと、繰り返し同じ要素が返されます。
- 戻り値:
- リスト内の直前の要素
- 例外:
- NoSuchElementException - 反復で直前の要素がない場合
nextIndex
public int nextIndex()
- 次に next を呼び出したときに返されることになる要素のインデックスを返します。リスト反復子がリストの最後にある場合はリストのサイズを返します。
- 戻り値:
- 次に next を呼び出したときに返されることになる要素のインデックス。リスト反復子がリストの最後にある場合はリストのサイズ
previousIndex
public int previousIndex()
- 次に previous を呼び出したときに返されることになる要素のインデックスを返します。リスト反復子がリストの先頭にある場合は -1 を返します。
- 戻り値:
- 次に previous を呼び出したときに返されることになる要素のインデックス。リスト反復子がリストの先頭にある場合は -1
remove
public void remove()
- next または previous によって返された最後の要素をリストから削除します (任意のオペレーション)。この呼び出しは next または previous の呼び出しごとに 1 回だけ行うことができます。この呼び出しは、前回の next または previous の呼び出し以降に ListIterator.add が呼び出されていない場合にだけ行うことができます。
- 定義:
- インタフェース Iterator 内の remove
- 例外:
- UnsupportedOperationException - remove オペレーションがリスト反復子によってサポートされていない場合
- IllegalStateException - next または previous のどちらも呼び出されていない場合、あるいは前回の next または previous の呼び出しのあとで remove または add が呼び出された場合
set
public void set(Object o)
- next または previous によって返された最後の要素を、指定された要素に置換します (任意のオペレーション)。この呼び出しは、前回の next または previous の呼び出し以降に ListIterator.remove と ListIterator.add のどちらも呼び出されていない場合にだけ行うことができます。
- 例外:
- UnsupportedOperationException - set オペレーションがリスト反復子にサポートされていない場合
- ClassCastException - 指定された要素のクラスのために、リストへ要素を追加できない場合
- IllegalArgumentException - 指定された要素の一部の特性のために、リストへ要素を追加できない場合
- IllegalStateException - next と previous のどちらも呼び出されていない場合、あるいは remove または前回の next または previous の呼び出しのあとで add が呼び出された場合
add
public void add(Object o)
- 指定された要素をリストに挿入します (任意のオペレーション)。要素は、next によって返される次の要素があればその要素の直前、および previous によって返される次の要素があればその要素の直後に挿入されます。リストに要素がない場合は、新しい要素がリストの唯一の要素になります。新しい要素は、暗黙カーソルの前に挿入されます。後続の next の呼び出しは影響を受けず、後続の previous の呼び出しは新しい要素を返します。この呼び出しは、nextIndex または previousIndex の呼び出しによって返される値を 1 増やします。
- 例外:
- UnsupportedOperationException - add メソッドがリスト反復子によってサポートされていない場合
- ClassCastException - 指定された要素のクラスのために、Set に要素を追加できない場合
- IllegalArgumentException - この要素の一部の特性のために、この Collection に要素を追加できない場合
バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.