stack

Interface StackInterface<T>

All Known Implementing Classes:

LinkedStack

public interface StackInterface<T>

An interface for the ADT stack.

Version:

4.0

Author:

Frank M. Carrano, Timothy M. Henry

Method Summary

Modifier and Type	Method and Description
void	clear() Removes all entries from this stack.
boolean	isEmpty() Detects whether this stack is empty.
T	peek() Retrieves this stack's top entry.
T	pop() Removes and returns this stack's top entry.
void	push(T newEntry) Adds a new entry to the top of this stack.

Method Detail

push

void push(T newEntry)

Adds a new entry to the top of this stack.

Parameters:

newEntry - An object to be added to the stack.

pop

T pop()

Removes and returns this stack's top entry.

Returns:

The object at the top of the stack.

Throws:

EmptyStackException - if the stack is empty before the operation.

peek

T peek()

Retrieves this stack's top entry.

Returns:

The object at the top of the stack.

Throws:

EmptyStackException - if the stack is empty.

isEmpty

boolean isEmpty()

Detects whether this stack is empty.

Returns:

True if the stack is empty.

clear

void clear()

Removes all entries from this stack.