Progeneric.Ptl.Containers.Adaptors

Class Stack64<T,TContainer extends IContainer64<T> & IBackSequence<T>>

java.lang.Object

Progeneric.Ptl.Containers.Adaptors.Stack64<T,TContainer>

Type Parameters:

T - The type of elements in the container.

TContainer - The type of the specified container.

Direct Known Subclasses:

Stack64

public class Stack64<T,TContainer extends IContainer64<T> & IBackSequence<T>>
extends java.lang.Object

Defines a container adaptor that provides a restricted subset of functionality, limiting access to the element most recently added to some underlying container type.

Constructor Summary

Constructors

Constructor and Description
Stack64(TContainer data) Creates a stack with an underlying container.

Method Summary

Methods

Modifier and Type	Method and Description
void	Clear() Erases all of the stack's elements.
TContainer	Container() Gets the underlying container of the current instance.
boolean	Empty() Returns true only if the stack does not contain any elements.
boolean	equals(java.lang.Object obj) Tests whether this instance is equal to a specified object.
boolean	equals(Stack64<T,TContainer> x) Tests whether this instance is equal to a specified Stack64.
int	hashCode() Returns the hash code for this instance.
long	MaxSize() Returns the maximum possible size of the stack.
T	Peek() Returns the object at the top of the stack without removing it.
void	Pop() Removes the element at the top of the stack.
void	Push(T item) Inserts an element at the top of the stack.
long	Size() Returns the number of elements contained in the stack.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Stack64

public Stack64(TContainer data)

Creates a stack with an underlying container.

Parameters:

data - The underlying container object.

Method Detail

Container

public TContainer Container()

Gets the underlying container of the current instance.

Returns:

The underlying container of the current instance.

Size

public long Size()

Returns the number of elements contained in the stack.

Returns:

The number of elements contained in the stack.

MaxSize

public long MaxSize()

Returns the maximum possible size of the stack.

Returns:

The maximum possible size of the stack.

Empty

public boolean Empty()

Returns true only if the stack does not contain any elements.

Returns:

True if the stack is empty; otherwise, false.

Peek

public T Peek()

Returns the object at the top of the stack without removing it.

Returns:

The element at the top of the stack.

Throws:

java.lang.RuntimeException - When the stack is empty.

Push

public void Push(T item)

Inserts an element at the top of the stack.

Parameters:

item - The element to be inserted at the top of the stack.

Throws:

java.lang.RuntimeException - When the stack is full.

Pop

public void Pop()

Removes the element at the top of the stack.

Throws:

java.lang.RuntimeException - When the stack is empty.

Clear

public void Clear()

Erases all of the stack's elements.

equals

public boolean equals(java.lang.Object obj)

Tests whether this instance is equal to a specified object.

Overrides:

equals in class java.lang.Object

Parameters:

obj - An object to compare with this instance.

Returns:

True if obj is an instance of Stack64 and equals the value of this instance; otherwise, false.

hashCode

public int hashCode()

Returns the hash code for this instance.

Overrides:

hashCode in class java.lang.Object

Returns:

A 32-bit signed integer hash code.

equals

public boolean equals(Stack64<T,TContainer> x)

Tests whether this instance is equal to a specified Stack64.

Parameters:

x - A Stack64 to compare with this instance.

Returns:

True if the specified Stack64 equals the value of this instance; otherwise, false.