lab2
Interface List

All Known Implementing Classes:

LinkedList, VectorList

public interface List

Interfaccia List: Specifica dei metodi per la gestione di una lista unidirezionale. Si noti che esistono altre possibili specifiche di lista con metodi diversi da quelli presentati e usando altri tipi di iteratori. I metodi qui introdotti si riferiscono alle classi di Java Collections API disponibili in java.util.* (JDK 1.2) [List].

 *********************** METODI PUBBLICI ***************************
 boolean add( Object x )       --> Inserisce x in fondo alla lista
 boolean remove( Object x )    --> Cancella la prima occorrenza di x
 boolean contains( Object x )  --> Verifica se x e' nella lista
 boolean isEmpty( )            --> Verifica se la lista e' vuota
 void clear( )                 --> Svuota la lista
 Iterator iterator( )          --> Iteratore per scandire la lista
 *********************** ECCEZIONI *********************************
 nessuna generata direttamente
 

Method Summary

boolean	add(java.lang.Object x) Inserisce un oggetto in fondo alla lista.
void	clear() Svuota la lista.
boolean	contains(java.lang.Object x) Verifica se la lista contiene l'oggetto specificato, usando il metodo standard equals (l'oggetto può occorrere più volte).
boolean	isEmpty() Verifica che la lista sia logicamente vuota.
Iterator	iterator() Restituisce un iteratore sulla lista per scandire gli oggetti in sequenza a partire dall'inizio della lista.
boolean	remove(java.lang.Object x) Cancella la prima occorrenza dell'oggetto a partire dall'inizio della lista, che rimane inalterata se non contiene l'oggetto.

Method Detail

add

public boolean add(java.lang.Object x)

Inserisce un oggetto in fondo alla lista. Non sono ammessi oggetti null.

Parameters:

x - l'oggetto da inserire, diverso da null.

Returns:

true come richiesto da Java Collection API.

Throws:

java.lang.IllegalArgumentException - se l'argomento passato è null.

remove

public boolean remove(java.lang.Object x)

Cancella la prima occorrenza dell'oggetto a partire dall'inizio della lista, che rimane inalterata se non contiene l'oggetto. Il metodo standard equals viene impiegato per trovare la prima occorrenza.

Parameters:

x - l'oggetto da cancellare, se presente e diverso da null.

Returns:

true se la lista contiene l'oggetto; false altrimenti.

Throws:

java.lang.IllegalArgumentException - se l'argomento passato è null.

contains

public boolean contains(java.lang.Object x)

Verifica se la lista contiene l'oggetto specificato, usando il metodo standard equals (l'oggetto può occorrere più volte).

Parameters:

x - l'oggetto da cercare nella lista.

Returns:

true se la lista contiene l'oggetto; false altrimenti.

Throws:

java.lang.IllegalArgumentException - se l'argomento passato è null.

isEmpty

public boolean isEmpty()

Verifica che la lista sia logicamente vuota.

Returns:

true se la lista è vuota; false altrimenti.

clear

public void clear()

Svuota la lista.

iterator

public Iterator iterator()

Restituisce un iteratore sulla lista per scandire gli oggetti in sequenza a partire dall'inizio della lista. Se la lista è modificata con metodi diversi da quelli dell'iteratore, viene generata una eccezione ConcurrentModificationException. In tal caso, l'iterazione termina per evitare comportamenti difficili da prevedere.

Returns:

una classe che realizza Iterator per scandire gli oggetti in sequenza dall'inizio.

Throws:

ConcurrentModificationException - se avviene una modifica concorrente mediante altri metodi.

See Also:

Iterator