128 lines
4.9 KiB
C
128 lines
4.9 KiB
C
/*
|
|
* Copyright (c) 2013 Hugh Bailey <obs.jim@gmail.com>
|
|
*
|
|
* Permission to use, copy, modify, and distribute this software for any
|
|
* purpose with or without fee is hereby granted, provided that the above
|
|
* copyright notice and this permission notice appear in all copies.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "c99defs.h"
|
|
|
|
/*
|
|
* Generic ini-style config file functions
|
|
*
|
|
* NOTE: It is highly recommended to use the default value functions (bottom of
|
|
* the file) before reading any variables from config files.
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct config_data;
|
|
typedef struct config_data config_t;
|
|
|
|
#define CONFIG_SUCCESS 0
|
|
#define CONFIG_FILENOTFOUND -1
|
|
#define CONFIG_ERROR -2
|
|
|
|
enum config_open_type {
|
|
CONFIG_OPEN_EXISTING,
|
|
CONFIG_OPEN_ALWAYS,
|
|
};
|
|
|
|
EXPORT config_t *config_create(const char *file);
|
|
EXPORT int config_open(config_t **config, const char *file,
|
|
enum config_open_type open_type);
|
|
EXPORT int config_open_string(config_t **config, const char *str);
|
|
EXPORT int config_save(config_t *config);
|
|
EXPORT int config_save_safe(config_t *config, const char *temp_ext,
|
|
const char *backup_ext);
|
|
EXPORT void config_close(config_t *config);
|
|
|
|
EXPORT size_t config_num_sections(config_t *config);
|
|
EXPORT const char *config_get_section(config_t *config, size_t idx);
|
|
|
|
EXPORT void config_set_string(config_t *config, const char *section,
|
|
const char *name, const char *value);
|
|
EXPORT void config_set_int(config_t *config, const char *section,
|
|
const char *name, int64_t value);
|
|
EXPORT void config_set_uint(config_t *config, const char *section,
|
|
const char *name, uint64_t value);
|
|
EXPORT void config_set_bool(config_t *config, const char *section,
|
|
const char *name, bool value);
|
|
EXPORT void config_set_double(config_t *config, const char *section,
|
|
const char *name, double value);
|
|
|
|
EXPORT const char *config_get_string(const config_t *config,
|
|
const char *section, const char *name);
|
|
EXPORT int64_t config_get_int(const config_t *config, const char *section,
|
|
const char *name);
|
|
EXPORT uint64_t config_get_uint(const config_t *config, const char *section,
|
|
const char *name);
|
|
EXPORT bool config_get_bool(const config_t *config, const char *section,
|
|
const char *name);
|
|
EXPORT double config_get_double(const config_t *config, const char *section,
|
|
const char *name);
|
|
|
|
EXPORT bool config_remove_value(config_t *config, const char *section,
|
|
const char *name);
|
|
|
|
/*
|
|
* DEFAULT VALUES
|
|
*
|
|
* The following functions are used to set what values will return if they do
|
|
* not exist. Call these functions *once* for each known value before reading
|
|
* any of them anywhere else.
|
|
*
|
|
* These do *not* actually set any values, they only set what values will be
|
|
* returned for config_get_* if the specified variable does not exist.
|
|
*
|
|
* You can initialize the defaults programmitically using config_set_default_*
|
|
* functions (recommended for most cases), or you can initialize it via a file
|
|
* with config_open_defaults.
|
|
*/
|
|
EXPORT int config_open_defaults(config_t *config, const char *file);
|
|
|
|
EXPORT void config_set_default_string(config_t *config, const char *section,
|
|
const char *name, const char *value);
|
|
EXPORT void config_set_default_int(config_t *config, const char *section,
|
|
const char *name, int64_t value);
|
|
EXPORT void config_set_default_uint(config_t *config, const char *section,
|
|
const char *name, uint64_t value);
|
|
EXPORT void config_set_default_bool(config_t *config, const char *section,
|
|
const char *name, bool value);
|
|
EXPORT void config_set_default_double(config_t *config, const char *section,
|
|
const char *name, double value);
|
|
|
|
/* These functions allow you to get the current default values rather than get
|
|
* the actual values. Probably almost never really needed */
|
|
EXPORT const char *config_get_default_string(const config_t *config,
|
|
const char *section, const char *name);
|
|
EXPORT int64_t config_get_default_int(const config_t *config,
|
|
const char *section, const char *name);
|
|
EXPORT uint64_t config_get_default_uint(const config_t *config,
|
|
const char *section, const char *name);
|
|
EXPORT bool config_get_default_bool(const config_t *config,
|
|
const char *section, const char *name);
|
|
EXPORT double config_get_default_double(const config_t *config,
|
|
const char *section, const char *name);
|
|
|
|
EXPORT bool config_has_user_value(const config_t *config,
|
|
const char *section, const char *name);
|
|
EXPORT bool config_has_default_value(const config_t *config,
|
|
const char *section, const char *name);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|