lab2
Interface Set

All Known Implementing Classes:

HashSet, TreeSet

public interface Set

Interfaccia Set: Specifica dei metodi per la gestione di un insieme di oggetti, non necessariamente ordinato, che differisce dalla lista List in quanto non sono ammessi duplicati. Il riferimento è a Java Collections API, disponibile in java.util.* (JDK 1.2) [List, Set] .

 *********************** METODI PUBBLICI ***************************
 boolean add( Object x )       --> Aggiunge x all'insieme
 boolean remove( Object x )    --> Elimina x dall'insieme
 boolean contains( Object x )  --> Verifica se x e' nell'insieme
 boolean isEmpty( )            --> Verifica se l'insieme e' vuoto
 void clear( )                 --> Rende vuoto l'insieme
 Iterator iterator( )          --> Iteratore per esaminare l'insieme
 *********************** ECCEZIONI *********************************
 nessuna
 

Method Summary

boolean	add(java.lang.Object x) Aggiunge un oggetto all'insieme.
void	clear() Rende l'insieme vuoto.
boolean	contains(java.lang.Object x) Verifica se l'insieme contiene l'oggetto specificato, usando il metodo standard equals (l'oggetto può occorrere al più una volta).
boolean	isEmpty() Verifica che l'insieme sia logicamente vuoto.
Iterator	iterator() Restituisce un iteratore per scandire gli oggetti dell'insieme senza un ordine particolare.
boolean	remove(java.lang.Object x) Elimina un oggetto dall'insieme, che rimane inalterato se non contiene l'oggetto.

Method Detail

add

public boolean add(java.lang.Object x)

Aggiunge un oggetto all'insieme. Non sono ammessi oggetti null e/o duplicati.

Parameters:

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

Returns:

true se l'oggetto non apparteneva già all'insieme; false altrimenti.

Throws:

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

remove

public boolean remove(java.lang.Object x)

Elimina un oggetto dall'insieme, che rimane inalterato se non contiene l'oggetto. Il metodo standard equals viene impiegato per trovare tale oggetto.

Parameters:

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

Returns:

true se l'oggetto appartiene all'insieme; false altrimenti.

Throws:

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

contains

public boolean contains(java.lang.Object x)

Verifica se l'insieme contiene l'oggetto specificato, usando il metodo standard equals (l'oggetto può occorrere al più una volta).

Parameters:

x - l'oggetto da cercare nell'insieme.

Returns:

true se l'insieme contiene l'oggetto; false altrimenti.

Throws:

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

isEmpty

public boolean isEmpty()

Verifica che l'insieme sia logicamente vuoto.

Returns:

true se l'insieme è vuoto; false altrimenti.

clear

public void clear()

Rende l'insieme vuoto.

iterator

public Iterator iterator()

Restituisce un iteratore per scandire gli oggetti dell'insieme senza un ordine particolare. Se l'insieme è mantenuto ordinato, l'iteratore scandisce gli oggetti secondo l'ordine. Nel caso che l'insieme venga modificato con metodi diversi da quelli dell'iteratore, viene generata una eccezione ConcurrentModificationException. In questo modo, l'iterazione termina per evitare comportamenti difficili da prevedere.

Returns:

una classe che realizza Iterator per scandire gli oggetti dell'insieme.

Throws:

ConcurrentModificationException - se avviene una modifica concorrente mediante altri metodi.

See Also:

Iterator