include/core/settings.hpp

   1 #ifndef _settings__hpp__included__
   2 #define _settings__hpp__included__
   3
   4 #include <string>
   5 #include <set>
   6 #include <stdexcept>
   7 #include <iostream>
   8
   9 /**
  10  * A setting.
  11  */
  12 class setting
  13 {
  14 public:
  15 /**
  16  * Create new setting.
  17  *
  18  * parameter name: Name of the setting.
  19  * throws std::bad_alloc: Not enough memory.
  20  */
  21         setting(const std::string& name) throw(std::bad_alloc);
  22
  23 /**
  24  * Remove the setting.
  25  */
  26         ~setting() throw();
  27
  28 /**
  29  * Set the setting to special blank state. Not all settings can be blanked.
  30  *
  31  * throws std::bad_alloc: Not enough memory.
  32  * throws std::runtime_error: Blanking this setting is not allowed (currently).
  33  */
  34         virtual void blank() throw(std::bad_alloc, std::runtime_error) = 0;
  35
  36 /**
  37  * Look up setting and try to blank it.
  38  *
  39  * parameter name: Name of setting to blank.
  40  * throws std::bad_alloc: Not enough memory.
  41  * throws std::runtime_error: Blanking this setting is not allowed (currently). Or setting does not exist.
  42  */
  43         static void blank(const std::string& name) throw(std::bad_alloc, std::runtime_error);
  44
  45 /**
  46  * Is this setting set (not blanked)?
  47  *
  48  * returns: True if setting is not blanked, false if it is blanked.
  49  */
  50         virtual bool is_set() throw() = 0;
  51
  52 /**
  53  * Look up a setting and see if it is set (not blanked)?
  54  *
  55  * parameter name: Name of setting to check.
  56  * returns: True if setting is not blanked, false if it is blanked.
  57  * throws std::bad_alloc: Not enough memory.
  58  * throws std::runtime_error: Setting does not exist.
  59  */
  60         static bool is_set(const std::string& name) throw(std::bad_alloc, std::runtime_error);
  61
  62 /**
  63  * Set value of setting.
  64  *
  65  * parameter value: New value for setting.
  66  * throws std::bad_alloc: Not enough memory.
  67  * throws std::runtime_error: Setting the setting to this value is not allowed (currently).
  68  */
  69         virtual void set(const std::string& value) throw(std::bad_alloc, std::runtime_error) = 0;
  70
  71 /**
  72  * Look up setting and set it.
  73  *
  74  * parameter name: Name of the setting.
  75  * parameter value: New value for setting.
  76  * throws std::bad_alloc: Not enough memory.
  77  * throws std::runtime_error: Setting the setting to this value is not allowed (currently). Or setting does not exist.
  78  */
  79         static void set(const std::string& name, const std::string& value) throw(std::bad_alloc, std::runtime_error);
  80
  81 /**
  82  * Get the value of setting.
  83  *
  84  * returns: The setting value.
  85  * throws std::bad_alloc: Not enough memory.
  86  */
  87         virtual std::string get() throw(std::bad_alloc) = 0;
  88
  89 /**
  90  * Look up setting an get value of it.
  91  *
  92  * returns: The setting value.
  93  * throws std::bad_alloc: Not enough memory.
  94  * throws std::runtime_error: Setting does not exist.
  95  */
  96         static std::string get(const std::string& name) throw(std::bad_alloc, std::runtime_error);
  97
  98 /**
  99  * Get set of all settings.
 100  */
 101         static std::set<std::string> get_settings_set() throw(std::bad_alloc);
 102 protected:
 103         std::string settingname;
 104 };
 105
 106 /**
 107  * Setting having numeric value.
 108  */
 109 class numeric_setting : public setting
 110 {
 111 public:
 112 /**
 113  * Create a new numeric setting.
 114  *
 115  * parameter sname: Name of the setting.
 116  * parameter minv: Minimum value for the setting.
 117  * parameter maxv: Maximum value for the setting.
 118  * parameter dflt: Default (initial) value for the setting.
 119  * throws std::bad_alloc: Not enough memory.
 120  */
 121         numeric_setting(const std::string& sname, int32_t minv, int32_t maxv, int32_t dflt) throw(std::bad_alloc);
 122 /**
 123  * Raises std::runtime_error as these settings can't be blanked.
 124  */
 125         void blank() throw(std::bad_alloc, std::runtime_error);
 126 /**
 127  * Returns true (these settings are always set).
 128  */
 129         bool is_set() throw();
 130 /**
 131  * Set the value of setting. Accepts only numeric values.
 132  *
 133  * parameter value: New value.
 134  * throws std::bad_alloc: Not enough memory.
 135  * throws std::runtime_error: Invalid value.
 136  */
 137         void set(const std::string& value) throw(std::bad_alloc, std::runtime_error);
 138 /**
 139  * Gets the value of the setting.
 140  *
 141  * returns: Value of setting as string.
 142  * throws std::bad_alloc: Not enough memory.
 143  */
 144         std::string get() throw(std::bad_alloc);
 145 /**
 146  * Get the value of setting as numeric.
 147  *
 148  * returns: Value of the setting as numeric.
 149  */
 150         operator int32_t() throw();
 151 private:
 152         int32_t value;
 153         int32_t minimum;
 154         int32_t maximum;
 155 };
 156
 157 /**
 158  * Setting having boolean value.
 159  */
 160 class boolean_setting : public setting
 161 {
 162 public:
 163 /**
 164  * Create a new boolean setting.
 165  *
 166  * parameter sname: Name of the setting.
 167  * parameter dflt: Default (initial) value for the setting.
 168  * throws std::bad_alloc: Not enough memory.
 169  */
 170         boolean_setting(const std::string& sname, bool dflt) throw(std::bad_alloc);
 171 /**
 172  * Raises std::runtime_error as these settings can't be blanked.
 173  */
 174         void blank() throw(std::bad_alloc, std::runtime_error);
 175 /**
 176  * Returns true (these settings are always set).
 177  */
 178         bool is_set() throw();
 179 /**
 180  * Set the value of setting.
 181  *
 182  * The following values are accepted as true: true, yes, on, 1, enable and enabled.
 183  * The following values are accepted as false: false, no, off, 0, disable and disabled.
 184  *
 185  * parameter value: New value.
 186  * throws std::bad_alloc: Not enough memory.
 187  * throws std::runtime_error: Invalid value.
 188  */
 189         void set(const std::string& value) throw(std::bad_alloc, std::runtime_error);
 190 /**
 191  * Gets the value of the setting.
 192  *
 193  * returns: Value of setting as string.
 194  * throws std::bad_alloc: Not enough memory.
 195  */
 196         std::string get() throw(std::bad_alloc);
 197 /**
 198  * Get the value of setting as boolean.
 199  *
 200  * returns: Value of the setting as boolean.
 201  */
 202         operator bool() throw();
 203 private:
 204         bool value;
 205 };
 206
 207 #endif