uoc.ei.tads
Interface Contenidor<E>

All Superinterfaces:
java.io.Serializable
All Known Subinterfaces:
Arbre<E>, Conjunt<E>, ContenidorAfitat<E>, Cua<E>, Diccionari<C,E>, Llista<E>, Pila<E>
All Known Implementing Classes:
ArbreAbstracte, ArbreAVL, ArbreBinari, ArbreBinariEncadenatImpl, ArbreBinariVectorImpl, ArbreGeneralDelegImpl, ConjuntAbstracte, ConjuntAVLImpl, ConjuntTaulaImpl, CuaAmbPrioritat, CuaAmbPrioritat.ArbreBinariQuasicompletVectorImpl, CuaVectorImpl, DiccionariAVLImpl, DiccionariLlistaImpl, DiccionariVectorImpl, LlistaDoblementEncadenada, LlistaEncadenada, PilaVectorImpl, TaulaDispersio

public interface Contenidor<E>
extends java.io.Serializable

Interfície que defineix les operacions de qualsevol TAD que es caracteritzi per contenir un conjunt d'elements. No es contemplen els mètodes crea() ni destrueix(): les classes que la implementin poden definir-los o deixar que el compilador faci servir el constructor per defecte, i el "garbage collector" per als objectes no referenciats. També defineix, a efectes pràctics, el mètode elements() que permet visualitzar tots els elements del contenidor mitjançant un iterador.

Since:
1.5

Method Summary
 Iterador<E> elements()
          Accessor de lectura dels elements que hi ha al contenidor.
 boolean estaBuit()
          Comprova si el contenidor està buit.
 int nombreElems()
          Accessor de lectura del nombre d'elements que hi ha al contenidor.
 

Method Detail

estaBuit

boolean estaBuit()
Comprova si el contenidor està buit.

Returns:
cert si el contenidor està buit

nombreElems

int nombreElems()
Accessor de lectura del nombre d'elements que hi ha al contenidor.

Returns:
nombre d'elements que hi ha al contenidor

elements

Iterador<E> elements()
Accessor de lectura dels elements que hi ha al contenidor. Retorna una enumeració. Es pot obtenir un llistat amb un parell de línies de codi:
 for ( Iterador it = tad.elements(); it.hiHaSeguent(); )
    System.out.println(it.seguent()); 
Enumerar és simplement enunciar l'una darrere l'altra (les coses d'una sèrie, les parts d'un tot). Però si el contenidor té definit algun tipus d'ordenació o de recorregut, l'enumeració ha de ser conseqüent i oferir els elements per ordre (FIFO, LIFO, inordre, etc.), sense alterar l'estat actual del contenidor.

Returns:
enumeració dels elements del contenidor
Throws:
ExcepcioPosicioInvalida - si es vol obtenir el següent element de l'enumeració i no n'hi ha cap o no n'hi ha cap més
See Also:
Iterador.hiHaSeguent(), Iterador.seguent()