runtime_history.h

Go to the documentation of this file.

#ifndef RUNTIME_HISTORY_CLASS
#define RUNTIME_HISTORY_CLASS

/*****************************************************************************\
*                                                                             *
*  Name   : runtime_history                                                   *
*  Author : Chris Koeritz                                                     *
*                                                                             *
*******************************************************************************
* Copyright (c) 1990-$now By Author.  This program is free software; you can  *
* redistribute it and/or modify it under the terms of the GNU General Public  *
* License as published by the Free Software Foundation; either version 2 of   *
* the License or (at your option) any later version.  This is online at:      *
*     http://www.fsf.org/copyleft/gpl.html                                    *
* Please send any updates to: fred@gruntose.com                               *
\*****************************************************************************/

#include "opsysdll.h"

#include <basis/packable.h>

const int DEFAULT_RUNTIME_HISTORY = 2000;

// forward.
class mutex;
class occurrence;
class occurrence_list;


class OPSYSTEM_CLASS_STYLE runtime_history : public packable
{
public:
  runtime_history(int maximum_length = DEFAULT_RUNTIME_HISTORY);
  ~runtime_history();

  void add_outcome(const occurrence &happening);

  // note that elements() and get() are thread safe, but unless one locks
  // the list, one is not guaranteed that the list of occurrences will not
  // change.  if you do lock the list, you must unlock it again afterwards.

  int elements() const;

  const occurrence &get(int index);

  void lock();  
  void unlock();  

  virtual void pack(byte_array &packed_form) const;
  virtual bool unpack(byte_array &packed_form);

  int max_items() const;
  void set_max_items(int new_max);

private:
  int _bound;  
  mutex *_lock;  
  occurrence_list *_occurrences;  

  const occurrence &empty_junk_occurrence();  
};

#endif

---