aboutsummaryrefslogtreecommitdiff
path: root/project/JavaCommon/src/com/modulus/common/collections/Stack.java
blob: 1d2c36c7538c33a1aa85679910b9951d0a9cf575 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
package com.modulus.common.collections;

/**
 * Class defines a better used stack than what is
 * in the java api. This stack is an interface
 * with many different implementations.
 * 
 * @author jrahm
 *
 * @param <T> the type this stack stores
 */
public interface Stack<T> {
	/**
	 * Removes and returns the element that is on
	 * the top of the stack.
	 * 
	 * @return the element which is on the top of the stack.
	 */
	public T pop();
	
	/**
	 * Places object <code>obj</code> on the top of
	 * the stack
	 * 
	 * @param obj the object to push on the stack.
	 */
	public void push(T obj);
	
	/**
	 * Returns the object on the top of the stack
	 * but does <b>not</b> remove it.
	 * 
	 * @return the object on the top of the stack
	 */
	public T peek();
	
	/**
	 * Returns the number of elements in this
	 * stack.
	 * 
	 * @return the number of elements in this stack.
	 */
	public int size();
	
	/**
	 * Returns true of this stack has no elements,
	 * returns false otherwise.
	 * 
	 * @return true it this stack has no elements, false otherwise
	 */
	public boolean isEmpty();
	
	/**
	 * Empties the stack.
	 */
	public void clear();
}