*/
enum ConfigDataType { DT_NOTHING, DT_INTEGER, DT_CHARPTR, DT_BOOLEAN };
+/** Holds a config value, either string, integer or boolean.
+ * Callback functions receive one or more of these, either on
+ * their own as a reference, or in a reference to a deque of them.
+ * The callback function can then alter the values of the ValueItem
+ * classes to validate the settings.
+ */
class ValueItem
{
std::string v;
public:
- ValueItem(int value)
+ ValueItem(int value);
+ ValueItem(bool value);
+ ValueItem(char* value);
+ void Set(char* value);
+ void Set(const char* val);
+ void Set(int value);
+ int GetInteger();
+ char* GetString();
+ bool GetBool();
+};
+
+/** The base class of the container 'ValueContainer'
+ * used internally by the core to hold core values.
+ */
+class ValueContainerBase
+{
+ public:
+ ValueContainerBase() { }
+ virtual ~ValueContainerBase() { }
+};
+
+/** ValueContainer is used to contain pointers to different
+ * core values such as the server name, maximum number of
+ * clients etc.
+ * It is specialized to hold a data type, then pointed at
+ * a value in the ServerConfig class. When the value has been
+ * read and validated, the Set method is called to write the
+ * value safely in a type-safe manner.
+ */
+template<typename T> class ValueContainer : public ValueContainerBase
+{
+ T val;
+
+ public:
+
+ ValueContainer()
{
- std::stringstream n;
- n << value;
- v = n.str();
+ val = NULL;
}
- ValueItem(bool value)
+ ValueContainer(T Val)
{
- std::stringstream n;
- n << value;
- v = n.str();
+ val = Val;
}
- ValueItem(char* value)
+ void Set(T newval, size_t s)
{
- v = value;
+ memcpy(val, newval, s);
}
+};
- int GetInteger() { return atoi(v.c_str()); };
+/** A specialization of ValueContainer to hold a pointer to a bool
+ */
+typedef ValueContainer<bool*> ValueContainerBool;
- const char* GetString() { return v.c_str(); };
+/** A specialization of ValueContainer to hold a pointer to
+ * an unsigned int
+ */
+typedef ValueContainer<unsigned int*> ValueContainerUInt;
- bool GetBool() { return GetInteger(); };
-};
+/** A specialization of ValueContainer to hold a pointer to
+ * a char array.
+ */
+typedef ValueContainer<char*> ValueContainerChar;
+
+/** A specialization of ValueContainer to hold a pointer to
+ * an int
+ */
+typedef ValueContainer<int*> ValueContainerInt;
+/** A set of ValueItems used by multi-value validator functions
+ */
typedef std::deque<ValueItem> ValueList;
/** A callback for validating a single value
*/
-typedef bool (*Validator)(ServerConfig* conf, const char*, const char*, void*);
+typedef bool (*Validator)(ServerConfig* conf, const char*, const char*, ValueItem&);
/** A callback for validating multiple value entries
*/
typedef bool (*MultiValidator)(ServerConfig* conf, const char*, char**, ValueList&, int*);
*/
typedef bool (*MultiNotify)(ServerConfig* conf, const char*);
-
/** Holds a core configuration item and its callbacks
*/
struct InitialConfig
{
char* tag;
char* value;
- void* val;
+ ValueContainerBase* val;
ConfigDataType datatype;
Validator validation_function;
};
*/
struct MultiConfig
{
- const char* tag;
- char* items[12];
- int datatype[12];
+ const char* tag;
+ char* items[12];
+ int datatype[12];
MultiNotify init_function;
MultiValidator validation_function;
MultiNotify finish_function;