org.dmfs.jems.stack

Interface Stack<Element>

Type Parameters:

Element - The type of the elements on the stack.

All Known Implementing Classes:

EmptyStack, SingleStack, Topped

public interface Stack<Element>

An immutable stack. By design elements can only be retrieved from the top.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Stack.StackTop<Element> The top of a Stack.

Method Summary

Modifier and Type	Method and Description
Optional<Stack.StackTop<Element>>	top() Retrieves the top of this Stack.

Method Detail

top

Optional<Stack.StackTop<Element>> top()

Retrieves the top of this Stack. If the stack is empty the Stack.StackTop will be absent.

Returns:

An Optional Stack.StackTop.