Stack.java

package com.rampatra.base;

/**
 * A generic interface for a stack.
 *
 * @author rampatra
 * @since 4/3/15
 */
public interface Stack<E> {
    /**
     * Pushes an item onto the top of this stack.
     *
     * @param item
     */
    public E push(E item);

    /**
     * Removes the object at the top of this stack and returns it.
     * This method throws an exception if this queue is empty.
     *
     * @return
     */
    public E pop();

    /**
     * Looks at the object at the top of this stack without
     * removing it from the stack. This method throws an
     * exception if this queue is empty.
     *
     * @return
     */
    public E peek();

    /**
     * Returns the number of items currently in the stack.
     *
     * @return
     */
    public int size();

    /**
     * Tests if this stack is empty.
     *
     * @return
     */
    public boolean isEmpty();

    /**
     * Prints the content of the stack.
     */
    public void print();
}