de.unkrig.commons.util.collections

Interface Stack<T>

Type Parameters:

T - The element type

All Superinterfaces:

java.util.Collection<T>, java.lang.Iterable<T>

All Known Implementing Classes:

ArrayStack

public interface Stack<T>
extends java.util.Collection<T>

The interface for an (unsynchronized) "stack", which is painfully missing from java.util.

The iteration order of the elements is (typically, but not necessarily) least-recently-added to most-recently-added.

Method Summary

Modifier and Type	Method and Description
T	peek()
T	pop() Removes and returns the element on the top of the stack.
void	push(T value) Pushes a value on the top of the stack.

Methods inherited from interface java.util.Collection

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray

Methods inherited from interface java.lang.Iterable

forEach

Method Detail

push

void push(T value)

Pushes a value on the top of the stack.

pop

T pop()

Removes and returns the element on the top of the stack.

Throws:

java.util.NoSuchElementException - The stack is empty

peek

T peek()

Returns:

The element on the top of the stack

Throws:

java.util.NoSuchElementException - The stack is empty