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
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
|
/* GConf
* Copyright (C) 1999, 2000 Red Hat Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 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
* Library 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, write to the
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef GCONF_GCONF_VALUE_H
#define GCONF_GCONF_VALUE_H
#include <glib.h>
#include <glib-object.h>
#include "gconf-error.h"
G_BEGIN_DECLS
/*
* A GConfValue is used to pass configuration values around
*/
typedef enum {
GCONF_VALUE_INVALID,
GCONF_VALUE_STRING,
GCONF_VALUE_INT,
GCONF_VALUE_FLOAT,
GCONF_VALUE_BOOL,
GCONF_VALUE_SCHEMA,
/* unfortunately these aren't really types; we want list_of_string,
list_of_int, etc. but it's just too complicated to implement.
instead we'll complain in various places if you do something
moronic like mix types in a list or treat pair<string,int> and
pair<float,bool> as the same type. */
GCONF_VALUE_LIST,
GCONF_VALUE_PAIR
} GConfValueType;
#define GCONF_VALUE_TYPE_VALID(x) (((x) > GCONF_VALUE_INVALID) && ((x) <= GCONF_VALUE_PAIR))
/* Forward declaration */
typedef struct _GConfSchema GConfSchema;
typedef struct _GConfValue GConfValue;
struct _GConfValue {
GConfValueType type;
};
const char* gconf_value_get_string (const GConfValue *value);
int gconf_value_get_int (const GConfValue *value);
double gconf_value_get_float (const GConfValue *value);
GConfValueType gconf_value_get_list_type (const GConfValue *value);
GSList* gconf_value_get_list (const GConfValue *value);
GConfValue* gconf_value_get_car (const GConfValue *value);
GConfValue* gconf_value_get_cdr (const GConfValue *value);
gboolean gconf_value_get_bool (const GConfValue *value);
GConfSchema* gconf_value_get_schema (const GConfValue *value);
GConfValue* gconf_value_new (GConfValueType type);
/* doesn't work on complicated types (only string, int, bool, float) */
GConfValue* gconf_value_new_from_string (GConfValueType type,
const gchar* str,
GError** err);
GType gconf_value_get_type (void) G_GNUC_CONST;
GConfValue* gconf_value_copy (const GConfValue* src);
void gconf_value_free (GConfValue* value);
void gconf_value_set_int (GConfValue* value,
gint the_int);
void gconf_value_set_string (GConfValue* value,
const gchar* the_str);
void gconf_value_set_float (GConfValue* value,
gdouble the_float);
void gconf_value_set_bool (GConfValue* value,
gboolean the_bool);
void gconf_value_set_schema (GConfValue* value,
const GConfSchema* sc);
void gconf_value_set_schema_nocopy (GConfValue* value,
GConfSchema* sc);
void gconf_value_set_car (GConfValue* value,
const GConfValue* car);
void gconf_value_set_car_nocopy (GConfValue* value,
GConfValue* car);
void gconf_value_set_cdr (GConfValue* value,
const GConfValue* cdr);
void gconf_value_set_cdr_nocopy (GConfValue* value,
GConfValue* cdr);
/* Set a list of GConfValue, NOT lists or pairs */
void gconf_value_set_list_type (GConfValue* value,
GConfValueType type);
void gconf_value_set_list_nocopy (GConfValue* value,
GSList* list);
void gconf_value_set_list (GConfValue* value,
GSList* list);
gchar* gconf_value_to_string (const GConfValue* value);
int gconf_value_compare (const GConfValue* value_a,
const GConfValue* value_b);
GConfValue* gconf_value_decode (const gchar *encoded);
gchar* gconf_value_encode (GConfValue *val);
/* Meta-information about a key. Not the same as a schema; this is
* information stored on the key, the schema is a specification
* that may apply to this key.
*/
/* FIXME GConfMetaInfo is basically deprecated in favor of stuffing this
* info into GConfEntry, though the transition isn't complete.
*/
/* Skipped from introspection because it's not registered as boxed */
/**
* GConfMetaInfo: (skip)
*
*/
typedef struct _GConfMetaInfo GConfMetaInfo;
struct _GConfMetaInfo {
gchar* schema;
gchar* mod_user; /* user owning the daemon that made the last modification */
GTime mod_time; /* time of the modification */
};
const char* gconf_meta_info_get_schema (GConfMetaInfo *gcmi);
const char* gconf_meta_info_get_mod_user (GConfMetaInfo *gcmi);
GTime gconf_meta_info_mod_time (GConfMetaInfo *gcmi);
GConfMetaInfo* gconf_meta_info_new (void);
void gconf_meta_info_free (GConfMetaInfo *gcmi);
void gconf_meta_info_set_schema (GConfMetaInfo *gcmi,
const gchar *schema_name);
void gconf_meta_info_set_mod_user (GConfMetaInfo *gcmi,
const gchar *mod_user);
void gconf_meta_info_set_mod_time (GConfMetaInfo *gcmi,
GTime mod_time);
/* Key-value pairs; used to list the contents of
* a directory
*/
typedef enum
{
GCONF_UNSET_INCLUDING_SCHEMA_NAMES = 1 << 0
} GConfUnsetFlags;
typedef struct _GConfEntry GConfEntry;
struct _GConfEntry {
char *key;
GConfValue *value;
};
GType gconf_entry_get_type (void) G_GNUC_CONST;
const char* gconf_entry_get_key (const GConfEntry *entry);
GConfValue* gconf_entry_get_value (const GConfEntry *entry);
const char* gconf_entry_get_schema_name (const GConfEntry *entry);
gboolean gconf_entry_get_is_default (const GConfEntry *entry);
gboolean gconf_entry_get_is_writable (const GConfEntry *entry);
GConfEntry* gconf_entry_new (const gchar *key,
const GConfValue *val);
GConfEntry* gconf_entry_new_nocopy (gchar *key,
GConfValue *val);
GConfEntry* gconf_entry_copy (const GConfEntry *src);
#ifndef GCONF_DISABLE_DEPRECATED
void gconf_entry_free (GConfEntry *entry);
#endif
void gconf_entry_ref (GConfEntry *entry);
void gconf_entry_unref (GConfEntry *entry);
/* Transfer ownership of value to the caller. */
GConfValue* gconf_entry_steal_value (GConfEntry *entry);
void gconf_entry_set_value (GConfEntry *entry,
const GConfValue *val);
void gconf_entry_set_value_nocopy (GConfEntry *entry,
GConfValue *val);
void gconf_entry_set_schema_name (GConfEntry *entry,
const gchar *name);
void gconf_entry_set_is_default (GConfEntry *entry,
gboolean is_default);
void gconf_entry_set_is_writable (GConfEntry *entry,
gboolean is_writable);
gboolean gconf_entry_equal (const GConfEntry *a,
const GConfEntry *b);
G_END_DECLS
#endif
|
