prog.utili
Class Insieme

java.lang.Object
  |
  +--prog.utili.Insieme

public class Insieme

extends java.lang.Object

Le sue istanze rappresentano insiemi di oggetti, cioè collezioni di oggetti che non contengono duplicazioni. Piú precisamente un insieme non contiene coppie di elementi e1 e e2 tali che e1.equals(e2) è vero.

Version:

1.0

Author:

Mauro Ferrari, Giovanni Pighizzini

Constructor Summary

Insieme()
Costruisce un insieme vuoto.

Method Summary

boolean	add(java.lang.Object o) Inserisce un nuovo oggetto nell'insieme se l'oggetto fornito come argomento non appartiene già all'insieme.
boolean	contains(java.lang.Object o) Restituisce true se l'insieme che esegue il metodo contiene l'oggetto specificato come argomento.
boolean	equals(java.lang.Object altro) Per verificare se l'insieme che esegue il metodo è uguale a quello specificato come argomento.
boolean	isEmpty() Restituisce true se l'insieme che esegue il metodo è vuoto.
java.util.Iterator	iterator() Restituisce un iteratore (un elenco) degli oggetti presenti nell'insieme che esegue il metodo.
boolean	remove(java.lang.Object o) Rimuove dall'insieme che esegue il metodo l'oggetto specificato come argomento.
int	size() Restituisce il numero di oggetti presenti nell'insieme.
java.lang.Object[]	toArray() Restituisce un array di oggetti che contiene tutti gli elementi dell'insieme che esegue il metodo.
java.lang.String	toString() Restituisce una stringa che descrive l'insieme.

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Insieme

public Insieme()

Costruisce un insieme vuoto.

Method Detail

add

public boolean add(java.lang.Object o)

Inserisce un nuovo oggetto nell'insieme se l'oggetto fornito come argomento non appartiene già all'insieme. Se l'argomento è null l'insieme non viene modificata e il metodo restituisce false. Se l'argomento non è null e l'insieme che esegue il metodo non contiene già un oggetto e tale che e.equals(o), allora l'oggetto viene aggiunto all'insieme e il metodo restituisce true altrimenti il metodo resituisce false.

Parameters:

o - l'oggetto da inserire nell'insieme.

Returns:

true se l'insieme non contiene già l'elemento specificato e o != null.

size

public int size()

Restituisce il numero di oggetti presenti nell'insieme.

Returns:

il numero di oggetti nell'insieme.

iterator

public java.util.Iterator iterator()

Restituisce un iteratore (un elenco) degli oggetti presenti nell'insieme che esegue il metodo. Gli elementi non compaiono nell'iteratore in un ordine particolare.

Returns:

l'iteratore degli oggetti contenuti nell'insieme.

isEmpty

public boolean isEmpty()

Restituisce true se l'insieme che esegue il metodo è vuoto.

Returns:

true se l'insieme non contiene alcun oggetto, false altrimenti.

contains

public boolean contains(java.lang.Object o)

Restituisce true se l'insieme che esegue il metodo contiene l'oggetto specificato come argomento. Piú precisamente restituisce true se e solo se l'insieme che esegue il metodo contiene un elemento e tale o.equals(e)) risulta vera.

Returns:

true se l'insieme non contiene l'oggetto specificato come argomento, false altrimenti.

remove

public boolean remove(java.lang.Object o)

Rimuove dall'insieme che esegue il metodo l'oggetto specificato come argomento. Piú precisamente, rimuove dall'insieme l'elemento e, se esiste, tale che o.equals(e).

Returns:

true se l'insieme conteneva l'oggetto specificato come argomento, false altrimenti.

toArray

public java.lang.Object[] toArray()

Restituisce un array di oggetti che contiene tutti gli elementi dell'insieme che esegue il metodo.

Returns:

l'array contente tutti gli oggetti presenti nell'insieme che esegue il metodo.

toString

public java.lang.String toString()

Restituisce una stringa che descrive l'insieme.

Overrides:

toString in class java.lang.Object

Returns:

la stringa che descrive l'insieme.

equals

public boolean equals(java.lang.Object altro)

Per verificare se l'insieme che esegue il metodo è uguale a quello specificato come argomento. Restituisce true se e solo se l'oggetto fornito come argomento è un insieme e i due insiemi contengono gli stessi oggetti.

Overrides:

equals in class java.lang.Object

Returns:

true se l'insieme che esegue il metodo è uguale a quello specificato come argomento e false altrimenti.