aboutsummaryrefslogtreecommitdiffstats
path: root/lib/libconfig.h
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--lib/libconfig.h19
-rw-r--r--lib/libconfig.h++468
-rw-r--r--lib/libconfig.hh2
3 files changed, 289 insertions, 200 deletions
diff --git a/lib/libconfig.h b/lib/libconfig.h
index 1774a26..e819038 100644
--- a/lib/libconfig.h
+++ b/lib/libconfig.h
@@ -1,6 +1,6 @@
/* ----------------------------------------------------------------------------
libconfig - A library for processing structured configuration files
- Copyright (C) 2005-2010 Mark A Lindner
+ Copyright (C) 2005-2014 Mark A Lindner
This file is part of libconfig.
@@ -40,8 +40,8 @@ extern "C" {
#endif /* WIN32 */
#define LIBCONFIG_VER_MAJOR 1
-#define LIBCONFIG_VER_MINOR 4
-#define LIBCONFIG_VER_REVISION 9
+#define LIBCONFIG_VER_MINOR 5
+#define LIBCONFIG_VER_REVISION 0
#include <stdio.h>
@@ -58,7 +58,11 @@ extern "C" {
#define CONFIG_FORMAT_DEFAULT 0
#define CONFIG_FORMAT_HEX 1
-#define CONFIG_OPTION_AUTOCONVERT 0x01
+#define CONFIG_OPTION_AUTOCONVERT 0x01
+#define CONFIG_OPTION_SEMICOLON_SEPARATORS 0x02
+#define CONFIG_OPTION_COLON_ASSIGNMENT_FOR_GROUPS 0x04
+#define CONFIG_OPTION_COLON_ASSIGNMENT_FOR_NON_GROUPS 0x08
+#define CONFIG_OPTION_OPEN_BRACE_ON_SEPARATE_LINE 0x10
#define CONFIG_TRUE (1)
#define CONFIG_FALSE (0)
@@ -102,7 +106,7 @@ typedef struct config_t
{
config_setting_t *root;
void (*destructor)(void *);
- unsigned short flags;
+ int options;
unsigned short tab_width;
short default_format;
const char *include_dir;
@@ -120,6 +124,9 @@ extern LIBCONFIG_API void config_write(const config_t *config, FILE *stream);
extern LIBCONFIG_API void config_set_default_format(config_t *config,
short format);
+extern LIBCONFIG_API void config_set_options(config_t *config, int options);
+extern LIBCONFIG_API int config_get_options(const config_t *config);
+
extern LIBCONFIG_API void config_set_auto_convert(config_t *config, int flag);
extern LIBCONFIG_API int config_get_auto_convert(const config_t *config);
@@ -260,7 +267,7 @@ extern LIBCONFIG_API void config_setting_set_hook(config_setting_t *setting,
extern LIBCONFIG_API config_setting_t *config_lookup(const config_t *config,
const char *path);
-extern LIBCONFIG_API config_setting_t *config_lookup_from(
+extern LIBCONFIG_API config_setting_t *config_setting_lookup(
config_setting_t *setting, const char *path);
extern LIBCONFIG_API int config_lookup_int(const config_t *config,
diff --git a/lib/libconfig.h++ b/lib/libconfig.h++
index 04be7a9..a43672c 100644
--- a/lib/libconfig.h++
+++ b/lib/libconfig.h++
@@ -1,6 +1,6 @@
/* ----------------------------------------------------------------------------
libconfig - A library for processing structured configuration files
- Copyright (C) 2005-2010 Mark A Lindner
+ Copyright (C) 2005-2014 Mark A Lindner
This file is part of libconfig.
@@ -40,8 +40,8 @@
#endif /* WIN32 */
#define LIBCONFIGXX_VER_MAJOR 1
-#define LIBCONFIGXX_VER_MINOR 4
-#define LIBCONFIGXX_VER_REVISION 9
+#define LIBCONFIGXX_VER_MINOR 5
+#define LIBCONFIGXX_VER_REVISION 0
struct config_t; // fwd decl
struct config_setting_t; // fwd decl
@@ -51,13 +51,18 @@ namespace libconfig {
class LIBCONFIGXX_API ConfigException : public std::exception { };
class Setting; // fwd decl
+class SettingIterator;
+class SettingConstIterator;
class LIBCONFIGXX_API SettingException : public ConfigException
{
- friend class Config;
-
public:
+ SettingException(const Setting &setting);
+ SettingException(const Setting &setting, int idx);
+ SettingException(const Setting &setting, const char *name);
+ SettingException(const char *path);
+
SettingException(const SettingException &other);
SettingException& operator=(const SettingException &other);
@@ -67,13 +72,6 @@ class LIBCONFIGXX_API SettingException : public ConfigException
virtual const char *what() const throw();
- protected:
-
- SettingException(const Setting &setting);
- SettingException(const Setting &setting, int idx);
- SettingException(const Setting &setting, const char *name);
- SettingException(const char *path);
-
private:
char *_path;
@@ -81,48 +79,33 @@ class LIBCONFIGXX_API SettingException : public ConfigException
class LIBCONFIGXX_API SettingTypeException : public SettingException
{
- friend class Config;
- friend class Setting;
-
public:
- virtual const char *what() const throw();
-
- private:
-
SettingTypeException(const Setting &setting);
SettingTypeException(const Setting &setting, int idx);
SettingTypeException(const Setting &setting, const char *name);
+
+ virtual const char *what() const throw();
};
class LIBCONFIGXX_API SettingNotFoundException : public SettingException
{
- friend class Config;
- friend class Setting;
-
public:
- virtual const char *what() const throw();
-
- private:
-
+ SettingNotFoundException(const char *path);
SettingNotFoundException(const Setting &setting, int idx);
SettingNotFoundException(const Setting &setting, const char *name);
- SettingNotFoundException(const char *path);
+
+ virtual const char *what() const throw();
};
class LIBCONFIGXX_API SettingNameException : public SettingException
{
- friend class Config;
- friend class Setting;
-
public:
- virtual const char *what() const throw();
-
- private:
-
SettingNameException(const Setting &setting, const char *name);
+
+ virtual const char *what() const throw();
};
class LIBCONFIGXX_API FileIOException : public ConfigException
@@ -134,29 +117,27 @@ class LIBCONFIGXX_API FileIOException : public ConfigException
class LIBCONFIGXX_API ParseException : public ConfigException
{
- friend class Config;
-
public:
+ ParseException(const char *file, int line, const char *error);
+
ParseException(const ParseException &other);
virtual ~ParseException() throw();
- inline const char *getFile() const throw()
+ inline const char *getFile() const
{ return(_file); }
- inline int getLine() const throw()
+ inline int getLine() const
{ return(_line); }
- inline const char *getError() const throw()
+ inline const char *getError() const
{ return(_error); }
virtual const char *what() const throw();
private:
- ParseException(const char *file, int line, const char *error);
-
const char *_file;
int _line;
const char *_error;
@@ -189,182 +170,288 @@ class LIBCONFIGXX_API Setting
FormatHex = 1
};
- private:
+ enum Option
+ {
+ OptionNone = 0,
+ OptionAutoConvert = 0x01,
+ OptionSemicolonSeparators = 0x02,
+ OptionColonAssignmentForGroups = 0x04,
+ OptionColonAssignmentForNonGroups = 0x08,
+ OptionOpenBraceOnSeparateLine = 0x10
+ };
- config_setting_t *_setting;
- Type _type;
- Format _format;
+ typedef SettingIterator iterator;
+ typedef SettingConstIterator const_iterator;
- Setting(config_setting_t *setting);
+ public:
- void assertType(Type type) const throw(SettingTypeException);
- static Setting & wrapSetting(config_setting_t *setting);
+ virtual ~Setting();
+
+ inline Type getType() const { return(_type); }
+
+ inline Format getFormat() const { return(_format); }
+ void setFormat(Format format);
+
+ operator bool() const;
+ operator int() const;
+ operator unsigned int() const;
+ operator long() const;
+ operator unsigned long() const;
+ operator long long() const;
+ operator unsigned long long() const;
+ operator double() const;
+ operator float() const;
+ operator const char *() const;
+ operator std::string() const;
+
+ inline const char *c_str() const
+ { return operator const char *(); }
+
+ Setting & operator=(bool value);
+ Setting & operator=(int value);
+ Setting & operator=(long value);
+ Setting & operator=(const long long &value);
+ Setting & operator=(const double &value);
+ Setting & operator=(float value);
+ Setting & operator=(const char *value);
+ Setting & operator=(const std::string &value);
+
+ Setting & lookup(const char *path) const;
+ inline Setting & lookup(const std::string &path) const
+ { return(lookup(path.c_str())); }
- Setting(const Setting& other); // not supported
- Setting& operator=(const Setting& other); // not supported
+ Setting & operator[](const char *name) const;
+ Setting & operator[](int index) const;
- public:
+ bool lookupValue(const char *name, bool &value) const;
+ bool lookupValue(const char *name, int &value) const;
+ bool lookupValue(const char *name, unsigned int &value) const;
+ bool lookupValue(const char *name, long long &value) const;
+ bool lookupValue(const char *name, unsigned long long &value) const;
+ bool lookupValue(const char *name, double &value) const;
+ bool lookupValue(const char *name, float &value) const;
+ bool lookupValue(const char *name, const char *&value) const;
+ bool lookupValue(const char *name, std::string &value) const;
- virtual ~Setting() throw();
-
- inline Type getType() const throw() { return(_type); }
-
- inline Format getFormat() const throw() { return(_format); }
- void setFormat(Format format) throw();
-
- operator bool() const throw(SettingTypeException);
- operator int() const throw(SettingTypeException);
- operator unsigned int() const throw(SettingTypeException);
- operator long() const throw(SettingTypeException);
- operator unsigned long() const throw(SettingTypeException);
- operator long long() const throw(SettingTypeException);
- operator unsigned long long() const throw(SettingTypeException);
- operator double() const throw(SettingTypeException);
- operator float() const throw(SettingTypeException);
- operator const char *() const throw(SettingTypeException);
- operator std::string() const throw(SettingTypeException);
-
- inline const char *c_str() const throw(SettingTypeException)
- { return operator const char*(); }
-
- Setting & operator=(bool value) throw(SettingTypeException);
- Setting & operator=(int value) throw(SettingTypeException);
- Setting & operator=(long value) throw(SettingTypeException);
- Setting & operator=(const long long &value) throw(SettingTypeException);
- Setting & operator=(const double &value) throw(SettingTypeException);
- Setting & operator=(float value) throw(SettingTypeException);
- Setting & operator=(const char *value) throw(SettingTypeException);
- Setting & operator=(const std::string &value) throw(SettingTypeException);
-
- Setting & operator[](const char *key) const
- throw(SettingTypeException, SettingNotFoundException);
-
- inline Setting & operator[](const std::string &key) const
- throw(SettingTypeException, SettingNotFoundException)
- { return(operator[](key.c_str())); }
-
- Setting & operator[](int index) const
- throw(SettingTypeException, SettingNotFoundException);
-
- bool lookupValue(const char *name, bool &value) const throw();
- bool lookupValue(const char *name, int &value) const throw();
- bool lookupValue(const char *name, unsigned int &value) const throw();
- bool lookupValue(const char *name, long long &value) const throw();
- bool lookupValue(const char *name, unsigned long long &value)
- const throw();
- bool lookupValue(const char *name, double &value) const throw();
- bool lookupValue(const char *name, float &value) const throw();
- bool lookupValue(const char *name, const char *&value) const throw();
- bool lookupValue(const char *name, std::string &value) const throw();
-
- inline bool lookupValue(const std::string &name, bool &value)
- const throw()
+ inline bool lookupValue(const std::string &name, bool &value) const
{ return(lookupValue(name.c_str(), value)); }
- inline bool lookupValue(const std::string &name, int &value)
- const throw()
+ inline bool lookupValue(const std::string &name, int &value) const
{ return(lookupValue(name.c_str(), value)); }
- inline bool lookupValue(const std::string &name, unsigned int &value)
- const throw()
+ inline bool lookupValue(const std::string &name, unsigned int &value) const
{ return(lookupValue(name.c_str(), value)); }
- inline bool lookupValue(const std::string &name, long long &value)
- const throw()
+ inline bool lookupValue(const std::string &name, long long &value) const
{ return(lookupValue(name.c_str(), value)); }
inline bool lookupValue(const std::string &name,
- unsigned long long &value) const throw()
+ unsigned long long &value) const
{ return(lookupValue(name.c_str(), value)); }
inline bool lookupValue(const std::string &name, double &value) const
- throw()
{ return(lookupValue(name.c_str(), value)); }
inline bool lookupValue(const std::string &name, float &value) const
- throw()
{ return(lookupValue(name.c_str(), value)); }
inline bool lookupValue(const std::string &name, const char *&value) const
- throw()
{ return(lookupValue(name.c_str(), value)); }
inline bool lookupValue(const std::string &name, std::string &value) const
- throw()
{ return(lookupValue(name.c_str(), value)); }
- void remove(const char *name)
- throw(SettingTypeException, SettingNotFoundException);
+ void remove(const char *name);
- inline void remove(const std::string & name)
- throw(SettingTypeException, SettingNotFoundException)
+ inline void remove(const std::string &name)
{ remove(name.c_str()); }
- void remove(unsigned int idx)
- throw(SettingTypeException, SettingNotFoundException);
+ void remove(unsigned int idx);
+
+ Setting & add(const char *name, Type type);
- inline Setting & add(const std::string & name, Type type)
- throw(SettingNameException, SettingTypeException)
+ inline Setting & add(const std::string &name, Type type)
{ return(add(name.c_str(), type)); }
- Setting & add(const char *name, Type type)
- throw(SettingNameException, SettingTypeException);
+ Setting & add(Type type);
- Setting & add(Type type) throw(SettingTypeException);
+ bool exists(const char *name) const;
- inline bool exists(const std::string &name) const throw()
+ inline bool exists(const std::string &name) const
{ return(exists(name.c_str())); }
- bool exists(const char *name) const throw();
-
- int getLength() const throw();
- const char *getName() const throw();
+ int getLength() const;
+ const char *getName() const;
std::string getPath() const;
- int getIndex() const throw();
+ int getIndex() const;
- const Setting & getParent() const throw(SettingNotFoundException);
- Setting & getParent() throw(SettingNotFoundException);
+ const Setting & getParent() const;
+ Setting & getParent();
- bool isRoot() const throw();
+ bool isRoot() const;
- inline bool isGroup() const throw()
+ inline bool isGroup() const
{ return(_type == TypeGroup); }
- inline bool isArray() const throw()
+ inline bool isArray() const
{ return(_type == TypeArray); }
- inline bool isList() const throw()
+ inline bool isList() const
{ return(_type == TypeList); }
- inline bool isAggregate() const throw()
+ inline bool isAggregate() const
{ return(_type >= TypeGroup); }
- inline bool isScalar() const throw()
+ inline bool isScalar() const
{ return((_type > TypeNone) && (_type < TypeGroup)); }
- inline bool isNumber() const throw()
- { return((_type == TypeInt) || (_type == TypeInt64)
- || (_type == TypeFloat)); }
+ inline bool isNumber() const
+ {
+ return((_type == TypeInt) || (_type == TypeInt64) || (_type == TypeFloat));
+ }
+
+ unsigned int getSourceLine() const;
+ const char *getSourceFile() const;
+
+ iterator begin();
+ iterator end();
- unsigned int getSourceLine() const throw();
- const char *getSourceFile() const throw();
+ const_iterator begin() const;
+ const_iterator end() const;
+
+ private:
+
+ config_setting_t *_setting;
+ Type _type;
+ Format _format;
+
+ Setting(config_setting_t *setting);
+
+ void assertType(Type type) const;
+ static Setting & wrapSetting(config_setting_t *setting);
+
+ Setting(const Setting& other); // not supported
+ Setting& operator=(const Setting& other); // not supported
};
-class LIBCONFIGXX_API Config
+
+class LIBCONFIGXX_API SettingIterator
{
+ public:
+
+ SettingIterator(Setting &setting, bool endIterator = false);
+ SettingIterator(const SettingIterator &other);
+ SettingIterator& operator=(const SettingIterator &other);
+
+ // Equality comparison.
+ inline bool operator==(SettingIterator const &other) const
+ { return((_setting == other._setting) && (_idx == other._idx)); }
+
+ inline bool operator!=(SettingIterator const &other) const
+ { return(!operator==(other)); }
+
+ bool operator<(SettingIterator const &other) const;
+
+ // Dereference operators.
+ inline Setting & operator*()
+ { return((*_setting)[_idx]); }
+
+ inline Setting * operator->()
+ { return(&(*_setting)[_idx]); }
+
+ inline const Setting & operator*() const
+ { return(*_setting)[_idx]; }
+ inline const Setting * operator->() const
+ { return(&(*_setting)[_idx]); }
+
+ // Increment and decrement operators.
+ SettingIterator & operator++();
+ SettingIterator operator++(int);
+
+ SettingIterator & operator--();
+ SettingIterator operator--(int);
+
+ // Arithmetic operators.
+ SettingIterator operator+(int offset) const;
+ SettingIterator & operator+=(int offset);
+
+ SettingIterator operator-(int offset) const;
+ SettingIterator & operator-=(int offset);
+
+ int operator-(const SettingIterator &other) const;
+
private:
- config_t *_config;
+ Setting *_setting;
- static void ConfigDestructor(void *arg);
- Config(const Config& other); // not supported
- Config& operator=(const Config& other); // not supported
+ int _count;
+ int _idx;
+};
+
+SettingIterator operator+(int offset, const SettingIterator &si);
+class LIBCONFIGXX_API SettingConstIterator
+{
+ public:
+
+ SettingConstIterator(const Setting &setting, bool endIterator = false);
+ SettingConstIterator(const SettingConstIterator &rhs);
+ SettingConstIterator& operator=(const SettingConstIterator &rhs);
+
+ // Equality comparison.
+ bool operator==(SettingConstIterator const &other) const
+ { return((_setting == other._setting) && (_idx == other._idx)); }
+
+ inline bool operator!=(SettingConstIterator const &other) const
+ { return(!operator==(other)); }
+
+ // Dereference operators.
+ inline Setting const & operator*()
+ { return((*_setting)[_idx]); }
+ inline Setting const * operator->()
+ { return(&(*_setting)[_idx]); }
+
+ inline const Setting& operator*() const
+ { return((*_setting)[_idx]); }
+ inline const Setting * operator->() const
+ { return(&(*_setting)[_idx]); }
+
+ // Increment and decrement operators.
+ SettingConstIterator & operator++();
+ SettingConstIterator operator++(int);
+
+ SettingConstIterator & operator--();
+ SettingConstIterator operator--(int);
+
+ // Arithmetic operators.
+ SettingConstIterator operator+(int offset) const;
+ SettingConstIterator & operator+=(int offset);
+
+ SettingConstIterator operator-(int offset) const;
+ SettingConstIterator & operator-=(int offset);
+
+ int operator-(const SettingConstIterator &other) const;
+
+ private:
+
+ const Setting *_setting;
+
+ int _count;
+ int _idx;
+};
+
+SettingConstIterator operator+(int offset, const SettingConstIterator &si);
+
+class LIBCONFIGXX_API Config
+{
public:
Config();
virtual ~Config();
+ void setOptions(int options);
+ int getOptions() const;
+
void setAutoConvert(bool flag);
bool getAutoConvert() const;
@@ -372,85 +459,80 @@ class LIBCONFIGXX_API Config
inline Setting::Format getDefaultFormat() const
{ return(_defaultFormat); }
- void setTabWidth(unsigned short width) throw();
- unsigned short getTabWidth() const throw();
+ void setTabWidth(unsigned short width);
+ unsigned short getTabWidth() const;
- void setIncludeDir(const char *includeDir) throw();
- const char *getIncludeDir() const throw();
+ void setIncludeDir(const char *includeDir);
+ const char *getIncludeDir() const;
- void read(FILE *stream) throw(ParseException);
+ void read(FILE *stream);
void write(FILE *stream) const;
- void readString(const char *str) throw(ParseException);
- inline void readString(const std::string &str) throw(ParseException)
+ void readString(const char *str);
+ inline void readString(const std::string &str)
{ return(readString(str.c_str())); }
- void readFile(const char *filename) throw(FileIOException, ParseException);
- void writeFile(const char *filename) throw(FileIOException);
+ void readFile(const char *filename);
+ void writeFile(const char *filename);
+ Setting & lookup(const char *path) const;
inline Setting & lookup(const std::string &path) const
- throw(SettingNotFoundException)
{ return(lookup(path.c_str())); }
- Setting & lookup(const char *path) const throw(SettingNotFoundException);
-
- inline bool exists(const std::string & path) const throw()
+ bool exists(const char *path) const;
+ inline bool exists(const std::string &path) const
{ return(exists(path.c_str())); }
- bool exists(const char *path) const throw();
-
- bool lookupValue(const char *path, bool &value) const throw();
- bool lookupValue(const char *path, int &value) const throw();
- bool lookupValue(const char *path, unsigned int &value) const throw();
- bool lookupValue(const char *path, long long &value) const throw();
- bool lookupValue(const char *path, unsigned long long &value)
- const throw();
- bool lookupValue(const char *path, double &value) const throw();
- bool lookupValue(const char *path, float &value) const throw();
- bool lookupValue(const char *path, const char *&value) const throw();
- bool lookupValue(const char *path, std::string &value) const throw();
-
- inline bool lookupValue(const std::string &path, bool &value) const throw()
+ bool lookupValue(const char *path, bool &value) const;
+ bool lookupValue(const char *path, int &value) const;
+ bool lookupValue(const char *path, unsigned int &value) const;
+ bool lookupValue(const char *path, long long &value) const;
+ bool lookupValue(const char *path, unsigned long long &value) const;
+ bool lookupValue(const char *path, double &value) const;
+ bool lookupValue(const char *path, float &value) const;
+ bool lookupValue(const char *path, const char *&value) const;
+ bool lookupValue(const char *path, std::string &value) const;
+
+ inline bool lookupValue(const std::string &path, bool &value) const
{ return(lookupValue(path.c_str(), value)); }
- inline bool lookupValue(const std::string &path, int &value) const throw()
+ inline bool lookupValue(const std::string &path, int &value) const
{ return(lookupValue(path.c_str(), value)); }
- inline bool lookupValue(const std::string &path, unsigned int &value)
- const throw()
+ inline bool lookupValue(const std::string &path, unsigned int &value) const
{ return(lookupValue(path.c_str(), value)); }
- inline bool lookupValue(const std::string &path, long long &value)
- const throw()
+ inline bool lookupValue(const std::string &path, long long &value) const
{ return(lookupValue(path.c_str(), value)); }
inline bool lookupValue(const std::string &path,
- unsigned long long &value) const throw()
+ unsigned long long &value) const
{ return(lookupValue(path.c_str(), value)); }
- inline bool lookupValue(const std::string &path, double &value)
- const throw()
+ inline bool lookupValue(const std::string &path, double &value) const
{ return(lookupValue(path.c_str(), value)); }
- inline bool lookupValue(const std::string &path, float &value)
- const throw()
+ inline bool lookupValue(const std::string &path, float &value) const
{ return(lookupValue(path.c_str(), value)); }
- inline bool lookupValue(const std::string &path, const char *&value)
- const throw()
+ inline bool lookupValue(const std::string &path, const char *&value) const
{ return(lookupValue(path.c_str(), value)); }
- inline bool lookupValue(const std::string &path, std::string &value)
- const throw()
+ inline bool lookupValue(const std::string &path, std::string &value) const
{ return(lookupValue(path.c_str(), value)); }
Setting & getRoot() const;
private:
+ static void ConfigDestructor(void *arg);
+ void handleError() const;
+
+ config_t *_config;
Setting::Format _defaultFormat;
- void handleError() const;
+ Config(const Config& other); // not supported
+ Config& operator=(const Config& other); // not supported
};
} // namespace libconfig
diff --git a/lib/libconfig.hh b/lib/libconfig.hh
index 6883a31..37fa052 100644
--- a/lib/libconfig.hh
+++ b/lib/libconfig.hh
@@ -1,6 +1,6 @@
/* ----------------------------------------------------------------------------
libconfig - A structured configuration file parsing library
- Copyright (C) 2005-2010 Mark A Lindner
+ Copyright (C) 2005-2014 Mark A Lindner
This file is part of libconfig.