include/library/emustatus.hpp

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