settings.hpp

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