lab2
Interface Iterator

All Known Implementing Classes:

HashSet.ProtectedItr, LinkedList.ProtectedItr, TreeSet.ProtectedItr, VectorList.ProtectedItr

public interface Iterator

Interfaccia Iterator: Specifica di iteratore nelle Java Collections API, riportata verbatim. Definisce implicitamente un cursore, posizionato prima dell'oggetto da esaminare inizialmente e quindi spostato sull'oggetto successivo a ogni chiamata di next, fintanto che ci sono oggetti da esaminare. Tale situazione è segnalata da hasNext. Si veda java.util.* (JDK 1.2) [Iterator].

 ****************************** METODI PUBBLICI ***************************
 boolean hasNext( )  --> Verifica se ci sono ulteriori oggetti da esaminare
 Object next( )      --> Restituisce il prossimo oggetto da esaminare
 void remove( )      --> Cancella l'ultimo oggetto restituito da next
 ****************************** ECCEZIONI *********************************
 next genera NoSuchElementException se invocata quando hasNet e' falsa;
 remove genera IllegalStateException se invocata impropriamente;
 next e remove generano ConcurrentModificationException se avviene
 una modifica con altri metodi.
 

Method Summary

boolean	hasNext() Indica se ci sono ulteriori elementi da esaminare nell'iterazione corrente.
java.lang.Object	next() Restituisce l'oggetto successivo da esaminare nell'iterazione.
void	remove() Cancella l'oggetto restituito dall'ultima chiamata al metodo next.

Method Detail

hasNext

public boolean hasNext()

Indica se ci sono ulteriori elementi da esaminare nell'iterazione corrente.

Returns:

true se ci sono ulteriori elementi; false altrimenti.

Throws:

ConcurrentModificationException - se avviene una modifica concorrente degli stessi oggetti mediante qualche altro metodo.

next

public java.lang.Object next()

Restituisce l'oggetto successivo da esaminare nell'iterazione.

Returns:

il prossimo oggetto da esaminare.

Throws:

NoSuchElementException - se non ci sono altri oggetti da esaminare.

ConcurrentModificationException - se avviene una modifica concorrente degli stessi oggetti mediante qualche altro metodo.

remove

public void remove()

Cancella l'oggetto restituito dall'ultima chiamata al metodo next. Il metodo può essere invocato solo una volta per ciascuna chiamata a next. Il comportamento è arbitrario in caso di modifica concorrente degli stessi oggetti, mediante qualche altro metodo.

Throws:

IllegalStateException - se nessuna chiamata al metodo next è stata precedentemente effettuata, oppure una chiamata a remove è stata già eseguita in corrispondenza della stessa chiamata a next.

ConcurrentModificationException - se avviene una modifica concorrente degli stessi oggetti mediante qualche altro metodo.