Package org.web3d.util

Class SimpleStackLogged

java.lang.Object

org.web3d.util.SimpleStack

org.web3d.util.SimpleStackLogged

All Implemented Interfaces:

SimpleStackInterface

public class SimpleStackLogged
extends SimpleStack

A stack that has a minimal implementation and no sychronisation. Looks all activity to help in debugging.

This stack is designed to be used in a high-speed, single threaded environment. It is directly backed by an array for fast access.

Version:

$Revision: 1.10 $

Author:

Alan Hudson

See Also:

• Stack

Field Summary

Fields inherited from class org.web3d.util.SimpleStack

STACK_START_SIZE

Constructor Summary

Constructors

Constructor	Description
SimpleStackLogged()	Constructs a new, empty hashtable with a default capacity and load factor, which is 20 respectively.
SimpleStackLogged(int initialCapacity)	Constructs a new, empty hashtable with the specified initial capacity and default load factor, which is 0.75.
SimpleStackLogged(int initialCapacity, String name)	Constructs a new, empty hashtable with the specified initial capacity and default load factor, which is 0.75.
SimpleStackLogged(String name)	Constructs a new, empty hashtable with a default capacity and load factor, which is 20 respectively.

Method Summary

Modifier and Type	Method	Description
void	clear()	Clears this stack so that it contains no values.
Object	peek()	Peek at the value on the top of the stack without removing it.
Object	pop()	Pop the value from the top of the stack.
void	push(Object val)	Push a new value onto the top of the stack.
void	remove(Object obj)	Remove the given object from the stack if it exists.
void	setDebugCalls(boolean debug)	Should we display all calls to this stack.
String	toStringHistory()	Get a string representation of the history.

Methods inherited from class org.web3d.util.SimpleStack

contains, isEmpty, size, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

SimpleStackLogged

public SimpleStackLogged()

Constructs a new, empty hashtable with a default capacity and load factor, which is 20 respectively.

SimpleStackLogged

public SimpleStackLogged(String name)

Constructs a new, empty hashtable with a default capacity and load factor, which is 20 respectively.

Parameters:

name -

SimpleStackLogged

public SimpleStackLogged(int initialCapacity)

Constructs a new, empty hashtable with the specified initial capacity and default load factor, which is 0.75.

Parameters:

initialCapacity - the initial capacity of the hashtable.

Throws:

IllegalArgumentException - if the initial capacity is less than zero.

SimpleStackLogged

public SimpleStackLogged(int initialCapacity,
 String name)

Constructs a new, empty hashtable with the specified initial capacity and default load factor, which is 0.75.

Parameters:

initialCapacity - the initial capacity of the hashtable.

name -

Throws:

IllegalArgumentException - if the initial capacity is less than zero.

Method Details

setDebugCalls

public void setDebugCalls(boolean debug)

Should we display all calls to this stack.

Parameters:

debug - Debug calls

push

public void push(Object val)

Push a new value onto the top of the stack. The value may be any legal reference to an object including null.

Specified by:

push in interface SimpleStackInterface

Overrides:

push in class SimpleStack

Parameters:

val - The new value for the stack.

pop

public Object pop()

Pop the value from the top of the stack. If the last value in the stack was null then this will return null.

Specified by:

pop in interface SimpleStackInterface

Overrides:

pop in class SimpleStack

Returns:

The top object on the stack

peek

public Object peek()
            throws EmptyStackException

Peek at the value on the top of the stack without removing it. If the value pushed was null, then null is returned here.

Specified by:

peek in interface SimpleStackInterface

Overrides:

peek in class SimpleStack

Returns:

A reference to the object on the top of the stack

Throws:

EmptyStackException - The stack is currently empty

remove

public void remove(Object obj)

Remove the given object from the stack if it exists. If it is not in the stack, then ignore it quietly.

Specified by:

remove in interface SimpleStackInterface

Overrides:

remove in class SimpleStack

Parameters:

obj - The object to be removed

clear

public void clear()

Clears this stack so that it contains no values.

Specified by:

clear in interface SimpleStackInterface

Overrides:

clear in class SimpleStack

toStringHistory

public String toStringHistory()

Get a string representation of the history.

Returns:

The history