Overview | Package | Class | Tree | Index | Help

Oracle® Coherence Java API Reference
v3.5.3
E15583-01
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.tangosol.util
Class SimpleStack

    java.lang.Object
      java.util.AbstractCollection
          java.util.AbstractList
              java.util.ArrayList
                  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:

- `add` a new element to the top of the stack
- `remove` and return the element on the top of the stack
- `return` the element on the top of the stack

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

Overview | Package | Class | Tree | Index | Help

Oracle® Coherence Java API Reference
v3.5.3
E15583-01
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2000, 2010, Oracle. All rights reserved.