lab2
Interface Stack

All Known Implementing Classes:

ArrayStack, ListStack

public interface Stack

Interfaccia Stack: Specifica dei metodi per la gestione della pila, con riferimento alle classi di Java Collections API disponibili in java.util.*.

 ******************* METODI PUBBLICI **********************
 Object push( Object x)  --> Inserisce x in cima alla pila
 Object pop( )           --> Estrae dalla cima della pila
 Object peek( )          --> Restituisce l'elemento in cima 
 boolean isEmpty( )      --> Verifica se la pila e' vuota
 void clear( )           --> Svuota la pila
 ****************** ECCEZIONI ******************************
 pop e peek generano EmptyStackException con pila vuota
 

Method Summary

void	clear() Svuota la pila.
boolean	isEmpty() Verifica che la pila sia logicamente vuota.
java.lang.Object	peek() Restituisce l'oggetto in cima alla pila senza estrarlo.
java.lang.Object	pop() Rimuove e restituisce l'oggetto in cima alla pila.
java.lang.Object	push(java.lang.Object x) Inserisce un oggetto in cima alla pila.

Method Detail

push

public java.lang.Object push(java.lang.Object x)

Inserisce un oggetto in cima alla pila.

Parameters:

x - l'oggetto da inserire.

Returns:

l'oggetto inserito.

Throws:

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

pop

public java.lang.Object pop()

Rimuove e restituisce l'oggetto in cima alla pila.

Returns:

l'oggetto in cima.

Throws:

EmptyStackException - con pila vuota.

peek

public java.lang.Object peek()

Restituisce l'oggetto in cima alla pila senza estrarlo.

Returns:

l'oggetto in cima.

Throws:

EmptyStackException - con pila vuota.

isEmpty

public boolean isEmpty()

Verifica che la pila sia logicamente vuota.

Returns:

true se la pila è vuota; false altrimenti.

clear

public void clear()

Svuota la pila.