package edd.util;

/**
 * Implementa una pila o stack genérica. Una pila es una colección 
 * secuencial que funciona con una política LIFO (last in, 
 * first out), en donde los elementos se insertan y remueven 
 * por un mismo extremo.
 * 
 * @author Ariel Ortiz
 *
 * @param <E> El tipo de los elementos contenidos en la pila.
 */
public class Stack<E> {
    
    /**
     * Constructor que permite crear una nueva pila genérica.
     */
    public Stack() {
        
    }
    
    /**
     * Inserta x en el tope de esta pila.
     * 
     * @param x El elemento a insertar en la pila.  
     */
    public void push(E x) {
        
    }
    
    /**
     * Remueve el elemento que se encuentra en el tope de esta pila.
     *   
     * @return El elemento removido.
     */
    public E pop() {
        return null;
    }
    
    /**
     * Devuelve, pero sin remover, el elemento que se encuentra en 
     * el tope de esta pila.
     * 
     * @return El elemento del tope de la pila.
     */
    public E peek() {
        return null;
    }
    
    /**
     * Indica si esta pila está vacía.
     * 
     * @return <code>true</code> si la pila está vacía, 
     * <code>false</code> en caso contrario.  
     */
    public boolean isEmpty() {
        return false;
    }
    
    /**
     * Indica el número de elementos contenidos actualmente en 
     * esta pila.
     *  
     * @return El número de elementos de la pila.
     */
    public int size() {
        return 0;
    }
}