1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
#include "command.h"
#include <stdbool.h>
#include <stdint.h>
/**
* The type of setting value.
*/
enum setting_type {
/** String setting. */
Setting_String = 0,
/** Number setting (a signed 64 bit integer). */
Setting_Number,
/** Boolean setting. */
Setting_Bool,
};
/**
* Value for a setting.
*/
struct setting_value {
/** Type of setting. */
enum setting_type type;
union {
/** String setting. */
char *string_value;
/** Real number setting. */
int64_t number_value;
/** Boolean setting value. */
bool bool_value;
};
};
/**
* A single setting.
*
* A setting has a "path", denoted by a string
* containing a number (0-) of dots.
* Example: editor.tab-width.
*/
struct setting {
/** Path of the setting. */
char path[128];
/** Hashed path that can be used for equality checks. */
uint32_t hash;
/** Value of the setting. */
struct setting_value value;
};
/**
* A collection of settings.
*/
struct settings {
/** Settings */
struct setting *settings;
/** Number of settings currently in collection. */
uint32_t nsettings;
/** Current capacity of collection. */
uint32_t capacity;
};
/**
* Initialize the global collection of settings.
*
* @param initial_capacity Initial capacity of the settings collection.
* @returns Nothing, the settings collection is a global instance.
*/
void settings_init(uint32_t initial_capacity);
/**
* Destroy the global collection of settings.
*/
void settings_destroy();
/**
* Register a new setting.
*
* @param path The path of the new setting on
* the form <category>.<sub-category>.<setting-name>.
* @param default_value The default value for the setting.
* All settings are required to declare a default value.
*/
void settings_register_setting(const char *path,
struct setting_value default_value);
/**
* Retrieve a single setting by path.
*
* @param path The exact path of the setting on
* the form <category>.<sub-category>.<setting-name>.
* @returns A pointer to the setting if found, NULL otherwise.
*/
struct setting *settings_get(const char *path);
/**
* Retrieve a collection of settings by prefix
*
* @param prefix Path prefix for the settings to retrieve.
* @param settings_out Pointer to an array that will be modified to point to the
* result.
* @param nsettings_out Pointer to an integer that will be set to the number of
* settings pointers in the result.
*/
void settings_get_prefix(const char *prefix, struct setting **settings_out[],
uint32_t *nsettings_out);
/**
* Set a value for a setting.
*
* @param path The exact path of the setting on
* the form <category>.<sub-category>.<setting-name>.
* @param value The new value of the setting. The type has to match the declared
* type for the setting. If not, the new value is ignored.
*/
void settings_set(const char *path, struct setting_value value);
int32_t settings_get_cmd(struct command_ctx ctx, int argc, const char *argv[]);
int32_t settings_set_cmd(struct command_ctx ctx, int argc, const char *argv[]);
static struct command SETTINGS_COMMANDS[] = {
{.name = "set", .fn = settings_set_cmd},
{.name = "get", .fn = settings_get_cmd},
};
|
