/** @file libconfig.h

 *  @brief Header file of library libconfig. */

/* ----------------------------------------------------------------------------

   libconfig - A library for processing structured configuration files

   Copyright (C) 2005-2010  Mark A Lindner

   This file is part of libconfig.

   This library is free software; you can redistribute it and/or

   modify it under the terms of the GNU Lesser General Public License

   as published by the Free Software Foundation; either version 2.1 of

   the License, or (at your option) any later version.

   This library is distributed in the hope that it will be useful, but

   WITHOUT ANY WARRANTY; without even the implied warranty of

   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

   Lesser General Public License for more details.

   You should have received a copy of the GNU Library General Public

   License along with this library; if not, see

   <http://www.gnu.org/licenses/>.

   ----------------------------------------------------------------------------

*/

#ifndef __libconfig_h

#define __libconfig_h

#ifdef __cplusplus

extern "C" {

#endif /* __cplusplus */

#if defined(_WIN32) || defined(__WIN32__) || defined(WIN32)

#if defined(LIBCONFIG_STATIC)

#define LIBCONFIG_API

#elif defined(LIBCONFIG_EXPORTS)

#define LIBCONFIG_API __declspec(dllexport)

#else /* ! LIBCONFIG_EXPORTS */

#define LIBCONFIG_API __declspec(dllimport)

#endif /* LIBCONFIG_STATIC */

#else /* ! WIN32 */

#define LIBCONFIG_API

#endif /* WIN32 */

#define LIBCONFIG_VER_MAJOR    1

#define LIBCONFIG_VER_MINOR    4

#define LIBCONFIG_VER_REVISION 9

#include <stdio.h>

#define CONFIG_TYPE_NONE    0

#define CONFIG_TYPE_GROUP   1

#define CONFIG_TYPE_INT     2

#define CONFIG_TYPE_INT64   3

#define CONFIG_TYPE_FLOAT   4

#define CONFIG_TYPE_STRING  5

#define CONFIG_TYPE_BOOL    6

#define CONFIG_TYPE_ARRAY   7

#define CONFIG_TYPE_LIST    8

#define CONFIG_FORMAT_DEFAULT  0

#define CONFIG_FORMAT_HEX      1

#define CONFIG_OPTION_AUTOCONVERT 0x01

#define CONFIG_TRUE  (1)

#define CONFIG_FALSE (0)

typedef union config_value_t

{

  int ival;

  long long llval;

  double fval;

  char *sval;

  struct config_list_t *list;

} config_value_t;

typedef struct config_setting_t

{

  char *name;

  short type;

  short format;

  config_value_t value;

  struct config_setting_t *parent;

  struct config_t *config;

  void *hook;

  unsigned int line;

  const char *file;

} config_setting_t;

typedef enum

{

  CONFIG_ERR_NONE = 0,

  CONFIG_ERR_FILE_IO = 1,

  CONFIG_ERR_PARSE = 2

} config_error_t;

typedef struct config_list_t

{

  unsigned int length;

  config_setting_t **elements;

} config_list_t;

typedef struct config_t

{

  config_setting_t *root;

  void (*destructor)(void *);

  unsigned short flags;

  unsigned short tab_width;

  short default_format;

  const char *include_dir;

  const char *error_text;

  const char *error_file;

  int error_line;

  config_error_t error_type;

  const char **filenames;

  unsigned int num_filenames;

} config_t;

extern LIBCONFIG_API int config_read(config_t *config, FILE *stream);

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_auto_convert(config_t *config, int flag);

extern LIBCONFIG_API int config_get_auto_convert(const config_t *config);

extern LIBCONFIG_API int config_read_string(config_t *config, const char *str);

extern LIBCONFIG_API int config_read_file(config_t *config,

                                          const char *filename);

extern LIBCONFIG_API int config_write_file(config_t *config,

                                           const char *filename);

extern LIBCONFIG_API void config_set_destructor(config_t *config,

                                                void (*destructor)(void *));

extern LIBCONFIG_API void config_set_include_dir(config_t *config,

                                                 const char *include_dir);

extern LIBCONFIG_API void config_init(config_t *config);

extern LIBCONFIG_API void config_destroy(config_t *config);

extern LIBCONFIG_API int config_setting_get_int(

  const config_setting_t *setting);

extern LIBCONFIG_API long long config_setting_get_int64(

  const config_setting_t *setting);

extern LIBCONFIG_API double config_setting_get_float(

  const config_setting_t *setting);

extern LIBCONFIG_API int config_setting_get_bool(

  const config_setting_t *setting);

extern LIBCONFIG_API const char *config_setting_get_string(

  const config_setting_t *setting);

extern LIBCONFIG_API int config_setting_lookup_int(

  const config_setting_t *setting, const char *name, int *value);

extern LIBCONFIG_API int config_setting_lookup_int64(

  const config_setting_t *setting, const char *name, long long *value);

extern LIBCONFIG_API int config_setting_lookup_float(

  const config_setting_t *setting, const char *name, double *value);

extern LIBCONFIG_API int config_setting_lookup_bool(

  const config_setting_t *setting, const char *name, int *value);

extern LIBCONFIG_API int config_setting_lookup_string(

  const config_setting_t *setting, const char *name, const char **value);

extern LIBCONFIG_API int config_setting_set_int(config_setting_t *setting,

                                                int value);

extern LIBCONFIG_API int config_setting_set_int64(config_setting_t *setting,

                                                  long long value);

extern LIBCONFIG_API int config_setting_set_float(config_setting_t *setting,

                                                  double value);

extern LIBCONFIG_API int config_setting_set_bool(config_setting_t *setting,

                                                 int value);

extern LIBCONFIG_API int config_setting_set_string(config_setting_t *setting,

                                                   const char *value);

extern LIBCONFIG_API int config_setting_set_format(config_setting_t *setting,

                                                   short format);

extern LIBCONFIG_API short config_setting_get_format(

  const config_setting_t *setting);

extern LIBCONFIG_API int config_setting_get_int_elem(

  const config_setting_t *setting, int idx);

extern LIBCONFIG_API long long config_setting_get_int64_elem(

  const config_setting_t *setting, int idx);

extern LIBCONFIG_API double config_setting_get_float_elem(

  const config_setting_t *setting, int idx);

extern LIBCONFIG_API int config_setting_get_bool_elem(

  const config_setting_t *setting, int idx);

extern LIBCONFIG_API const char *config_setting_get_string_elem(

  const config_setting_t *setting, int idx);

extern LIBCONFIG_API config_setting_t *config_setting_set_int_elem(

  config_setting_t *setting, int idx, int value);

extern LIBCONFIG_API config_setting_t *config_setting_set_int64_elem(

  config_setting_t *setting, int idx, long long value);

extern LIBCONFIG_API config_setting_t *config_setting_set_float_elem(

  config_setting_t *setting, int idx, double value);

extern LIBCONFIG_API config_setting_t *config_setting_set_bool_elem(

  config_setting_t *setting, int idx, int value);

extern LIBCONFIG_API config_setting_t *config_setting_set_string_elem(

  config_setting_t *setting, int idx, const char *value);

#define /* const char * */ config_get_include_dir(/* const config_t * */ C) \

  ((C)->include_dir)

#define /* int */ config_setting_type(/* const config_setting_t * */ S) \

  ((S)->type)

#define /* int */ config_setting_is_group(/* const config_setting_t * */ S) \

  ((S)->type == CONFIG_TYPE_GROUP)

#define /* int */ config_setting_is_array(/* const config_setting_t * */ S) \

  ((S)->type == CONFIG_TYPE_ARRAY)

#define /* int */ config_setting_is_list(/* const config_setting_t * */ S) \

  ((S)->type == CONFIG_TYPE_LIST)

#define /* int */ config_setting_is_aggregate( \

  /* const config_setting_t * */ S)                                     \

  (((S)->type == CONFIG_TYPE_GROUP) || ((S)->type == CONFIG_TYPE_LIST)  \

   || ((S)->type == CONFIG_TYPE_ARRAY))

#define /* int */ config_setting_is_number(/* const config_setting_t * */ S) \

  (((S)->type == CONFIG_TYPE_INT)                                       \

   || ((S)->type == CONFIG_TYPE_INT64)                                  \

   || ((S)->type == CONFIG_TYPE_FLOAT))

#define /* int */ config_setting_is_scalar(/* const config_setting_t * */ S) \

  (((S)->type == CONFIG_TYPE_BOOL) || ((S)->type == CONFIG_TYPE_STRING) \

   || config_setting_is_number(S))

#define /* const char * */ config_setting_name( \

  /* const config_setting_t * */ S)             \

  ((S)->name)

#define /* config_setting_t * */ config_setting_parent( \

  /* const config_setting_t * */ S)                     \

  ((S)->parent)

#define /* int */ config_setting_is_root(       \

  /* const config_setting_t * */ S)             \

  ((S)->parent ? CONFIG_FALSE : CONFIG_TRUE)

extern LIBCONFIG_API int config_setting_index(const config_setting_t *setting);

extern LIBCONFIG_API int config_setting_length(

  const config_setting_t *setting);

extern LIBCONFIG_API config_setting_t *config_setting_get_elem(

  const config_setting_t *setting, unsigned int idx);

extern LIBCONFIG_API config_setting_t *config_setting_get_member(

  const config_setting_t *setting, const char *name);

extern LIBCONFIG_API config_setting_t *config_setting_add(

  config_setting_t *parent, const char *name, int type);

extern LIBCONFIG_API int config_setting_remove(config_setting_t *parent,

                                               const char *name);

extern LIBCONFIG_API int config_setting_remove_elem(config_setting_t *parent,

                                                    unsigned int idx);

extern LIBCONFIG_API void config_setting_set_hook(config_setting_t *setting,

                                                  void *hook);

#define config_setting_get_hook(S) ((S)->hook)

extern LIBCONFIG_API config_setting_t *config_lookup(const config_t *config,

                                                     const char *path);

extern LIBCONFIG_API config_setting_t *config_lookup_from(

  config_setting_t *setting, const char *path);

extern LIBCONFIG_API int config_lookup_int(const config_t *config,

                                           const char *path, int *value);

extern LIBCONFIG_API int config_lookup_int64(const config_t *config,

                                             const char *path,

                                             long long *value);

extern LIBCONFIG_API int config_lookup_float(const config_t *config,

                                             const char *path, double *value);

extern LIBCONFIG_API int config_lookup_bool(const config_t *config,

                                            const char *path, int *value);

extern LIBCONFIG_API int config_lookup_string(const config_t *config,

                                              const char *path,

                                              const char **value);

#define /* config_setting_t * */ config_root_setting( \

  /* const config_t * */ C)                           \

  ((C)->root)

#define  /* void */ config_set_default_format(/* config_t * */ C,       \

                                              /* short */ F)            \

  (C)->default_format = (F)

#define /* short */ config_get_default_format(/* config_t * */ C)       \

  ((C)->default_format)

#define /* void */ config_set_tab_width(/* config_t * */ C,     \

                                        /* unsigned short */ W) \

  (C)->tab_width = ((W) & 0x0F)

#define /* unsigned char */ config_get_tab_width(/* const config_t * */ C) \

  ((C)->tab_width)

#define /* unsigned short */ config_setting_source_line(   \

  /* const config_setting_t * */ S)                        \

  ((S)->line)

#define /* const char */ config_setting_source_file(    \

  /* const config_setting_t * */ S)                     \

  ((S)->file)

#define /* const char * */ config_error_text(/* const config_t * */ C)  \

  ((C)->error_text)

#define /* const char * */ config_error_file(/* const config_t * */ C)  \

  ((C)->error_file)

#define /* int */ config_error_line(/* const config_t * */ C)   \

  ((C)->error_line)

#define /* config_error_t */ config_error_type(/* const config_t * */ C) \

  ((C)->error_type)

#ifdef __cplusplus

}

#endif /* __cplusplus */

#endif /* __libconfig_h */