it.unimi.dsi.fastutil
Interface Stack<K>

All Known Subinterfaces:

BooleanStack, ByteStack, CharStack, DoubleStack, FloatStack, IntStack, LongStack, ShortStack

All Known Implementing Classes:

AbstractBooleanList, AbstractBooleanList.BooleanSubList, AbstractBooleanStack, AbstractByteList, AbstractByteList.ByteSubList, AbstractByteStack, AbstractCharList, AbstractCharList.CharSubList, AbstractCharStack, AbstractDoubleList, AbstractDoubleList.DoubleSubList, AbstractDoubleStack, AbstractFloatList, AbstractFloatList.FloatSubList, AbstractFloatStack, AbstractIntList, AbstractIntList.IntSubList, AbstractIntStack, AbstractLongList, AbstractLongList.LongSubList, AbstractLongStack, AbstractObjectList, AbstractObjectList.ObjectSubList, AbstractReferenceList, AbstractReferenceList.ReferenceSubList, AbstractShortList, AbstractShortList.ShortSubList, AbstractShortStack, AbstractStack, BooleanArrayList, BooleanLists.Singleton, ByteArrayFrontCodedList, ByteArrayList, ByteLists.Singleton, CharArrayFrontCodedList, CharArrayList, CharLists.Singleton, DoubleArrayList, DoubleLists.Singleton, FloatArrayList, FloatLists.Singleton, IntArrayFrontCodedList, IntArrayList, IntLists.Singleton, LongArrayFrontCodedList, LongArrayList, LongLists.Singleton, ObjectArrayList, ObjectLists.Singleton, ReferenceArrayList, ReferenceLists.Singleton, ShortArrayFrontCodedList, ShortArrayList, ShortLists.Singleton

public interface Stack<K>

A stack.

A stack must provide the classical push(Object) and pop() operations, but may be also peekable to some extent: it may provide just the top() function, or even a more powerful peek(int) method that provides access to all elements on the stack (indexed from the top, which has index 0).

Method Summary

boolean	isEmpty() Checks whether the stack is empty.
K	peek(int i) Peeks at an element on the stack (optional operation).
K	pop() Pops the top off the stack.
void	push(K o) Pushes the given object on the stack.
K	top() Peeks at the top of the stack (optional operation).

Method Detail

push

void push(K o)

Pushes the given object on the stack.

Parameters:

o - the object that will become the new top of the stack.

pop

K pop()

Pops the top off the stack.

Returns:

the top of the stack.

Throws:

NoSuchElementException - if the stack is empty.

isEmpty

boolean isEmpty()

Checks whether the stack is empty.

Returns:

true if the stack is empty.

top

K top()

Peeks at the top of the stack (optional operation).

Returns:

the top of the stack.

Throws:

NoSuchElementException - if the stack is empty.

peek

K peek(int i)

Peeks at an element on the stack (optional operation).

Returns:

the i-th element on the stack; 0 represents the top.

Throws:

IndexOutOfBoundsException - if the designated element does not exist..