NAME

Solstice::Stack - A basic stack object.

SYNOPSIS

  use Solstice::Stack;

  my $stack = new Solstice::Stack;

  # Push an element onto the stack
  $stack->push($element);
  
  # Remove the last element in the stack, and return it
  $element = $stack->pop();

  # Return the last element in the stack
  $element = $stack->top();

  # Clear the stack
  $stack->clear();

  my $iterator = $list->iterator();
  while ($iterator->hasNext()) {
    my $element = $iterator->next();
  }

DESCRIPTION

Provides a set of functionality for creating and manipulating a stack.

Export

No symbols exported.

Methods

new ()

Creates and returns an empty Solstice::Stack object.

clear()

Removes all entries from the Stack object.

push($element)

Adds an element to the end of the Stack.

pop()

Remove the last element in the Stack and return it.

top()

Returns the last element in the Stack, without removing it.

isEmpty()

Returns a boolean describing whether the internal Stack array is empty.

_init()

Initialize the Stack by clearing it.

Modules Used

Carp.

AUTHOR

Catalyst Group, <catalyst@u.washington.edu>

VERSION

$Revision: 2065 $

COPYRIGHT

Copyright 1998-2007 Office of Learning Technologies, University of Washington

Licensed under the Educational Community License, Version 1.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: http://www.opensource.org/licenses/ecl1.php

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.