Skip navigation links

Oracle® Coherence Java API Reference
Release 3.6.1.0

E18814-01


com.tangosol.util
Class SimpleStack

java.lang.Object
  extended by java.util.AbstractCollection
      extended by java.util.AbstractList
          extended by java.util.ArrayList
              extended by com.tangosol.util.SimpleStack

All Implemented Interfaces:
java.io.Serializable, java.lang.Cloneable, java.lang.Iterable, java.util.Collection, java.util.List, java.util.RandomAccess

public class SimpleStack
extends java.util.ArrayList

A LIFO (last in, first out) unbounded stack of objects. A SimpleStack supports the following operations:

This class is similar to Stack except that it extends ArrayList rather than Vector and is therefore not thread safe. The top of the stack corresponds to the last element in the underlying list, whereas the bottom corresponds to the first.

The SimpleStack implementation supports null elements; however, if null elements are added, care must be taken to distinguish a null element returned from pop() or peek() from a null value that indicates the stack is empty.

Since:
Coherence 3.2
Author:
jh 2006.05.04

Field Summary

 

Fields inherited from class java.util.AbstractList
modCount

 

Constructor Summary
SimpleStack()
          Create a new empty SimpleStack.
SimpleStack(int nCapacity)
          Create a new empty SimpleStack with the specified initial capacity.

 

Method Summary
 java.lang.Object peek()
          Return the object that is currently on top of the stack.
 java.lang.Object pop()
          Remove and return the object that is currently on top of the stack.
 void push(java.lang.Object oElement)
          Add the given object to the top of the stack.

 

Methods inherited from class java.util.ArrayList
add, add, addAll, addAll, clear, clone, contains, ensureCapacity, get, indexOf, isEmpty, lastIndexOf, remove, remove, removeRange, set, size, toArray, toArray, trimToSize

 

Methods inherited from class java.util.AbstractList
equals, hashCode, iterator, listIterator, listIterator, subList

 

Methods inherited from class java.util.AbstractCollection
containsAll, removeAll, retainAll, toString

 

Methods inherited from interface java.util.List
containsAll, equals, hashCode, iterator, listIterator, listIterator, removeAll, retainAll, subList

 

Constructor Detail

SimpleStack

public SimpleStack()
Create a new empty SimpleStack.

SimpleStack

public SimpleStack(int nCapacity)
Create a new empty SimpleStack with the specified initial capacity.
Parameters:
nCapacity - the initial capacity of the underlying list used to store elements

Method Detail

push

public void push(java.lang.Object oElement)
Add the given object to the top of the stack.
Parameters:
oElement - the object to place on top of the stack

pop

public java.lang.Object pop()
Remove and return the object that is currently on top of the stack.
Returns:
the object removed from the top of the stack or null if the stack is empty

peek

public java.lang.Object peek()
Return the object that is currently on top of the stack.
Returns:
the object on top of the stack or null if the stack is empty

Skip navigation links

Oracle® Coherence Java API Reference
Release 3.6.1.0

E18814-01


Copyright © 2000, 2010, Oracle and/or its affiliates. All rights reserved.