tpl_listQueue.H

/*
  This file is part of Aleph system

  Copyright (c) 2002, 2003, 2004, 2005, 2006
  UNIVERSITY LOS ANDES (ULA) Merida - REPÚBLICA BOLIVARIANA DE VENEZUELA  

  - Center of Studies in Microelectronics & Distributed Systems (CEMISID) 
  - ULA Computer Science Department
  - FUNDACITE Mérida - Ministerio de Ciencia y Tecnología

  PERMISSION TO USE, COPY, MODIFY AND DISTRIBUTE THIS SOFTWARE AND ITS
  DOCUMENTATION IS HEREBY GRANTED, PROVIDED THAT BOTH THE COPYRIGHT
  NOTICE AND THIS PERMISSION NOTICE APPEAR IN ALL COPIES OF THE
  SOFTWARE, DERIVATIVE WORKS OR MODIFIED VERSIONS, AND ANY PORTIONS
  THEREOF, AND THAT BOTH NOTICES APPEAR IN SUPPORTING DOCUMENTATION.

  Aleph is distributed in the hope that it will be useful, but WITHOUT
  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  or FITNESS FOR A PARTICULAR PURPOSE.

  UNIVERSIDAD DE LOS ANDES requests users of this software to return to 

  Leandro Leon
  CEMISID 
  Ed La Hechicera 
  3er piso, ala sur
  Facultad de Ingenieria 
  Universidad de Los Andes 
  Merida - REPÚBLICA BOLIVARIANA DE VENEZUELA    or

  lrleon@ula.ve

  any improvements or extensions that they make and grant Universidad 
  de Los Andes (ULA) the rights to redistribute these changes. 

  Aleph is (or was) granted by: 
  - Consejo de Desarrollo Cientifico, Humanistico, Tecnico de la ULA 
    (CDCHT)
  - Fundacite Mérida
*/


# ifndef TPL_LISTQUEUE_H
# define TPL_LISTQUEUE_H

# include <tpl_snode.H>

using namespace Aleph;

namespace Aleph {

    template <typename T>
class ListQueue 
{
  
  public:

    typedef Snode<T> Node;

  private:

  Node * rear_ptr;
  size_t num_nodes;

public:

  ListQueue() : rear_ptr(NULL), num_nodes(0) { /* empty */ }
  void put(Node * node)
  {

    I(node->is_empty());

    if (num_nodes > 0)
      rear_ptr->insert_next(node);

    num_nodes++;
    rear_ptr = node;
  }
  Node * get() throw(std::exception, std::underflow_error)
  {
    if (num_nodes == 0)
      throw std::underflow_error("stack is empty");

    Node * ret_val = rear_ptr->remove_next(); 
    num_nodes--;

    if (num_nodes == 0)
      rear_ptr = NULL;

    return ret_val;
  }
  Node * front() const throw(std::exception, std::underflow_error)
  {
    if (num_nodes == 0)
      throw std::underflow_error("stack is empty");

    return rear_ptr->get_next();
  }

  Node * rear() const throw(std::exception, std::underflow_error)
  {
    if (num_nodes == 0)
      throw std::underflow_error("stack is empty");

    return rear_ptr;
  }
  size_t size() const { return num_nodes; }

  bool is_empty() const { return num_nodes == 0; }
};

} // end namespace Aleph

# endif /* TPL_LISTQUEUE_H */

---