include/library/emustatus.hpp

   1 #ifndef _library__emustatus__hpp__included__
   2 #define _library__emustatus__hpp__included__
   3
   4 #include "library/workthread.hpp"
   5
   6 #include <map>
   7 #include <string>
   8
   9 class emulator_status
  10 {
  11 public:
  12 /**
  13  * Constructor.
  14  *
  15  * Throws std::bad_alloc: Not enough memory.
  16  */
  17         emulator_status() throw(std::bad_alloc);
  18 /**
  19  * Destructor
  20  */
  21         ~emulator_status() throw();
  22 /**
  23  * Insert/Replace key.
  24  *
  25  * Parameter key: Key to insert/replace.
  26  * Parameter value: The value to assign.
  27  * Throws std::bad_alloc: Not enough memory.
  28  */
  29         void set(const std::string& key, const std::string& value) throw(std::bad_alloc);
  30 /**
  31  * Has key?
  32  *
  33  * Parameter key: Key to check.
  34  * Returns: True if key exists, false if not.
  35  */
  36         bool haskey(const std::string& key) throw();
  37 /**
  38  * Erase key.
  39  *
  40  * Parameter key: Key to erase.
  41  */
  42         void erase(const std::string& key) throw();
  43 /**
  44  * Read key.
  45  *
  46  * Parameter key: The key to read.
  47  * Returns: The value of key ("" if not found).
  48  */
  49         std::string get(const std::string& key) throw(std::bad_alloc);
  50 /**
  51  * Iterator.
  52  */
  53         struct iterator
  54         {
  55 /**
  56  * Not valid flag.
  57  */
  58                 bool not_valid;
  59 /**
  60  * Key.
  61  */
  62                 std::string key;
  63 /**
  64  * Value.
  65  */
  66                 std::string value;
  67         };
  68 /**
  69  * Get first iterator
  70  *
  71  * Returns: Before-the-start iterator.
  72  * Throws std::bad_alloc: Not enough memory.
  73  */
  74         iterator first() throw(std::bad_alloc);
  75 /**
  76  * Get next value.
  77  *
  78  * Parameter itr: Iterator to advance.
  79  * Returns: True if next value was found, false if not.
  80  * Throws std::bad_alloc: Not enough memory.
  81  */
  82         bool next(iterator& itr) throw(std::bad_alloc);
  83 private:
  84         emulator_status(const emulator_status&);
  85         emulator_status& operator=(const emulator_status&);
  86         mutex_class lock;
  87         std::map<std::string, std::string> content;
  88 };
  89
  90 #endif