mirror of
https://github.com/obsproject/obs-studio.git
synced 2024-09-20 04:42:18 +02:00
41fad2d1a4
This Fixes a minor flaw with the API where data had to always be mutable to be usable by the API. Functions that do not modify the fundamental underlying data of a structure should be marked as constant, both for safety and to signify that the parameter is input only and will not be modified by the function using it.
123 lines
4.6 KiB
C
123 lines
4.6 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_save(config_t *config);
|
|
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);
|
|
|
|
/*
|
|
* 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
|