~ubuntu-branches/ubuntu/quantal/gconf/quantal

void (<a class="link" href="gconf-gconf.html#GConfNotifyFunc" title="GConfNotifyFunc ()">*GConfNotifyFunc</a>) (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

guint cnxn_id,

<a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a> *entry,

gpointer user_data);

guint <a class="link" href="gconf-gconf.html#gconf-engine-notify-add" title="gconf_engine_notify_add ()">gconf_engine_notify_add</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

const gchar *namespace_section,

<a class="link" href="gconf-gconf.html#GConfNotifyFunc" title="GConfNotifyFunc ()">GConfNotifyFunc</a> func,

gpointer user_data,

GError **err);

void <a class="link" href="gconf-gconf.html#gconf-engine-notify-remove" title="gconf_engine_notify_remove ()">gconf_engine_notify_remove</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

guint cnxn);

<a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* <a class="link" href="gconf-gconf.html#gconf-engine-get" title="gconf_engine_get ()">gconf_engine_get</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

const gchar *key,

GError **err);

<a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* <a class="link" href="gconf-gconf.html#gconf-engine-get-without-default" title="gconf_engine_get_without_default ()">gconf_engine_get_without_default</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

const gchar *key,

GError **err);

<a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a>* <a class="link" href="gconf-gconf.html#gconf-engine-get-entry" title="gconf_engine_get_entry ()">gconf_engine_get_entry</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

const gchar *key,

const gchar *locale,

gboolean use_schema_default,

GError **err);

<a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* <a class="link" href="gconf-gconf.html#gconf-engine-get-with-locale" title="gconf_engine_get_with_locale ()">gconf_engine_get_with_locale</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

const gchar *key,

const gchar *locale,

GError **err);

<pre class="synopsis"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-init" title="gconf_init ()">gconf_init</a> (<code>int argc</code>,

<code>char **argv</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

void <a class="link" href="gconf-gconf.html#gconf-preinit" title="gconf_preinit ()">gconf_preinit</a> (<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> app</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> mod_info</code>);

void <a class="link" href="gconf-gconf.html#gconf-postinit" title="gconf_postinit ()">gconf_postinit</a> (<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> app</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> mod_info</code>);

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-is-initialized" title="gconf_is_initialized ()">gconf_is_initialized</a> (<code>void</code>);

void (<a class="link" href="gconf-gconf.html#GConfNotifyFunc" title="GConfNotifyFunc ()">*GConfNotifyFunc</a>) (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> cnxn_id</code>,

<code><a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a> *entry</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> <a class="link" href="gconf-gconf.html#gconf-engine-notify-add" title="gconf_engine_notify_add ()">gconf_engine_notify_add</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *namespace_section</code>,

<code><a class="link" href="gconf-gconf.html#GConfNotifyFunc" title="GConfNotifyFunc ()">GConfNotifyFunc</a> func</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

void <a class="link" href="gconf-gconf.html#gconf-engine-notify-remove" title="gconf_engine_notify_remove ()">gconf_engine_notify_remove</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> cnxn</code>);

<a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* <a class="link" href="gconf-gconf.html#gconf-engine-get" title="gconf_engine_get ()">gconf_engine_get</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* <a class="link" href="gconf-gconf.html#gconf-engine-get-without-default" title="gconf_engine_get_without_default ()">gconf_engine_get_without_default</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a>* <a class="link" href="gconf-gconf.html#gconf-engine-get-entry" title="gconf_engine_get_entry ()">gconf_engine_get_entry</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *locale</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> use_schema_default</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* <a class="link" href="gconf-gconf.html#gconf-engine-get-with-locale" title="gconf_engine_get_with_locale ()">gconf_engine_get_with_locale</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *locale</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

(<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

const gchar *key,

GError **err);

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-set" title="gconf_engine_set ()">gconf_engine_set</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

const gchar *key,

const <a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a> *value,

GError **err);

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-unset" title="gconf_engine_unset ()">gconf_engine_unset</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

const gchar *key,

GError **err);

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-associate-schema" title="gconf_engine_associate_schema ()">gconf_engine_associate_schema</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

const gchar *key,

const gchar *schema_key,

GError **err);

GSList* <a class="link" href="gconf-gconf.html#gconf-engine-all-entries" title="gconf_engine_all_entries ()">gconf_engine_all_entries</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

const gchar *dir,

GError **err);

GSList* <a class="link" href="gconf-gconf.html#gconf-engine-all-dirs" title="gconf_engine_all_dirs ()">gconf_engine_all_dirs</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

const gchar *dir,

GError **err);

void <a class="link" href="gconf-gconf.html#gconf-engine-suggest-sync" title="gconf_engine_suggest_sync ()">gconf_engine_suggest_sync</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

GError **err);

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-dir-exists" title="gconf_engine_dir_exists ()">gconf_engine_dir_exists</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

const gchar *dir,

100

GError **err);

101

void <a class="link" href="gconf-gconf.html#gconf-engine-remove-dir" title="gconf_engine_remove_dir ()">gconf_engine_remove_dir</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

102

const gchar *dir,

103

GError **err);

104

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-key-is-writable" title="gconf_engine_key_is_writable ()">gconf_engine_key_is_writable</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

105

const gchar *key,

106

GError **err);

107

gboolean <a class="link" href="gconf-gconf.html#gconf-valid-key" title="gconf_valid_key ()">gconf_valid_key</a> (const gchar *key,

108

gchar **why_invalid);

109

gboolean <a class="link" href="gconf-gconf.html#gconf-key-is-below" title="gconf_key_is_below ()">gconf_key_is_below</a> (const gchar *above,

110

const gchar *below);

111

gchar* <a class="link" href="gconf-gconf.html#gconf-concat-dir-and-key" title="gconf_concat_dir_and_key ()">gconf_concat_dir_and_key</a> (const gchar *dir,

112

const gchar *key);

113

gchar* <a class="link" href="gconf-gconf.html#gconf-unique-key" title="gconf_unique_key ()">gconf_unique_key</a> (void);

114

char* <a class="link" href="gconf-gconf.html#gconf-escape-key" title="gconf_escape_key ()">gconf_escape_key</a> (const char *arbitrary_text,

115

int len);

116

char* <a class="link" href="gconf-gconf.html#gconf-unescape-key" title="gconf_unescape_key ()">gconf_unescape_key</a> (const char *escaped_key,

117

int len);

118

gdouble <a class="link" href="gconf-gconf.html#gconf-engine-get-float" title="gconf_engine_get_float ()">gconf_engine_get_float</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

119

const gchar *key,

120

GError **err);

121

gint <a class="link" href="gconf-gconf.html#gconf-engine-get-int" title="gconf_engine_get_int ()">gconf_engine_get_int</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

122

const gchar *key,

123

GError **err);

124

gchar* <a class="link" href="gconf-gconf.html#gconf-engine-get-string" title="gconf_engine_get_string ()">gconf_engine_get_string</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

125

const gchar *key,

126

GError **err);

127

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-get-bool" title="gconf_engine_get_bool ()">gconf_engine_get_bool</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

128

const gchar *key,

129

GError **err);

130

<a class="link" href="gconf-gconf-schema.html#GConfSchema" title="GConfSchema">GConfSchema</a>* <a class="link" href="gconf-gconf.html#gconf-engine-get-schema" title="gconf_engine_get_schema ()">gconf_engine_get_schema</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

131

const gchar *key,

132

GError **err);

133

GSList* <a class="link" href="gconf-gconf.html#gconf-engine-get-list" title="gconf_engine_get_list ()">gconf_engine_get_list</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

134

const gchar *key,

135

<a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> list_type,

136

GError **err);

137

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-get-pair" title="gconf_engine_get_pair ()">gconf_engine_get_pair</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

138

const gchar *key,

139

<a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> car_type,

140

<a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> cdr_type,

141

gpointer car_retloc,

142

gpointer cdr_retloc,

143

GError **err);

144

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-set-float" title="gconf_engine_set_float ()">gconf_engine_set_float</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

145

const gchar *key,

146

gdouble val,

147

GError **err);

148

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-set-int" title="gconf_engine_set_int ()">gconf_engine_set_int</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

149

const gchar *key,

150

gint val,

151

GError **err);

152

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-set-string" title="gconf_engine_set_string ()">gconf_engine_set_string</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

153

const gchar *key,

154

const gchar *val,

155

GError **err);

156

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-set-bool" title="gconf_engine_set_bool ()">gconf_engine_set_bool</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

157

const gchar *key,

158

gboolean val,

159

GError **err);

160

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-set-schema" title="gconf_engine_set_schema ()">gconf_engine_set_schema</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

161

const gchar *key,

162

const <a class="link" href="gconf-gconf-schema.html#GConfSchema" title="GConfSchema">GConfSchema</a> *val,

163

GError **err);

164

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-set-list" title="gconf_engine_set_list ()">gconf_engine_set_list</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

165

const gchar *key,

166

<a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> list_type,

167

GSList *list,

168

GError **err);

169

gboolean <a class="link" href="gconf-gconf.html#gconf-engine-set-pair" title="gconf_engine_set_pair ()">gconf_engine_set_pair</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

170

const gchar *key,

171

<a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> car_type,

172

<a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> cdr_type,

173

gconstpointer address_of_car,

174

gconstpointer address_of_cdr,

175

GError **err);

(<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-set" title="gconf_engine_set ()">gconf_engine_set</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code>const <a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a> *value</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-unset" title="gconf_engine_unset ()">gconf_engine_unset</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-associate-schema" title="gconf_engine_associate_schema ()">gconf_engine_associate_schema</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *schema_key</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList">GSList</a>* <a class="link" href="gconf-gconf.html#gconf-engine-all-entries" title="gconf_engine_all_entries ()">gconf_engine_all_entries</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList">GSList</a>* <a class="link" href="gconf-gconf.html#gconf-engine-all-dirs" title="gconf_engine_all_dirs ()">gconf_engine_all_dirs</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

void <a class="link" href="gconf-gconf.html#gconf-engine-suggest-sync" title="gconf_engine_suggest_sync ()">gconf_engine_suggest_sync</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-dir-exists" title="gconf_engine_dir_exists ()">gconf_engine_dir_exists</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

100

void <a class="link" href="gconf-gconf.html#gconf-engine-remove-dir" title="gconf_engine_remove_dir ()">gconf_engine_remove_dir</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

101

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

102

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

103

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-key-is-writable" title="gconf_engine_key_is_writable ()">gconf_engine_key_is_writable</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

104

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

105

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

106

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-valid-key" title="gconf_valid_key ()">gconf_valid_key</a> (<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

107

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> **why_invalid</code>);

108

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-key-is-below" title="gconf_key_is_below ()">gconf_key_is_below</a> (<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *above</code>,

109

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *below</code>);

110

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="gconf-gconf.html#gconf-concat-dir-and-key" title="gconf_concat_dir_and_key ()">gconf_concat_dir_and_key</a> (<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

111

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>);

112

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="gconf-gconf.html#gconf-unique-key" title="gconf_unique_key ()">gconf_unique_key</a> (<code>void</code>);

113

char* <a class="link" href="gconf-gconf.html#gconf-escape-key" title="gconf_escape_key ()">gconf_escape_key</a> (<code>const char *arbitrary_text</code>,

114

<code>int len</code>);

115

char* <a class="link" href="gconf-gconf.html#gconf-unescape-key" title="gconf_unescape_key ()">gconf_unescape_key</a> (<code>const char *escaped_key</code>,

116

<code>int len</code>);

117

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a> <a class="link" href="gconf-gconf.html#gconf-engine-get-float" title="gconf_engine_get_float ()">gconf_engine_get_float</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

118

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

119

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

120

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> <a class="link" href="gconf-gconf.html#gconf-engine-get-int" title="gconf_engine_get_int ()">gconf_engine_get_int</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

121

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

122

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

123

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="gconf-gconf.html#gconf-engine-get-string" title="gconf_engine_get_string ()">gconf_engine_get_string</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

124

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

125

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

126

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-get-bool" title="gconf_engine_get_bool ()">gconf_engine_get_bool</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

127

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

128

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

129

<a class="link" href="gconf-gconf-schema.html#GConfSchema" title="GConfSchema">GConfSchema</a>* <a class="link" href="gconf-gconf.html#gconf-engine-get-schema" title="gconf_engine_get_schema ()">gconf_engine_get_schema</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

130

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

131

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

132

<a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList">GSList</a>* <a class="link" href="gconf-gconf.html#gconf-engine-get-list" title="gconf_engine_get_list ()">gconf_engine_get_list</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

133

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

134

<code><a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> list_type</code>,

135

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

136

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-get-pair" title="gconf_engine_get_pair ()">gconf_engine_get_pair</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

137

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

138

<code><a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> car_type</code>,

139

<code><a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> cdr_type</code>,

140

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> car_retloc</code>,

141

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> cdr_retloc</code>,

142

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

143

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-set-float" title="gconf_engine_set_float ()">gconf_engine_set_float</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

144

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

145

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a> val</code>,

146

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

147

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-set-int" title="gconf_engine_set_int ()">gconf_engine_set_int</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

148

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

149

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> val</code>,

150

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

151

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-set-string" title="gconf_engine_set_string ()">gconf_engine_set_string</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

152

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

153

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *val</code>,

154

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

155

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-set-bool" title="gconf_engine_set_bool ()">gconf_engine_set_bool</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

156

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

157

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> val</code>,

158

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

159

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-set-schema" title="gconf_engine_set_schema ()">gconf_engine_set_schema</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

160

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

161

<code>const <a class="link" href="gconf-gconf-schema.html#GConfSchema" title="GConfSchema">GConfSchema</a> *val</code>,

162

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

163

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-set-list" title="gconf_engine_set_list ()">gconf_engine_set_list</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

164

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

165

<code><a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> list_type</code>,

166

<code><a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList">GSList</a> *list</code>,

167

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

168

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-engine-set-pair" title="gconf_engine_set_pair ()">gconf_engine_set_pair</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

169

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

170

<code><a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> car_type</code>,

171

<code><a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> cdr_type</code>,

172

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gconstpointer">gconstpointer</a> address_of_car</code>,

173

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gconstpointer">gconstpointer</a> address_of_cdr</code>,

174

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

176

175

<a class="link" href="gconf-gconf.html#GConfEnumStringPair" title="GConfEnumStringPair">GConfEnumStringPair</a>;

177

gboolean <a class="link" href="gconf-gconf.html#gconf-string-to-enum" title="gconf_string_to_enum ()">gconf_string_to_enum</a> (<a class="link" href="gconf-gconf.html#GConfEnumStringPair" title="GConfEnumStringPair">GConfEnumStringPair</a> lookup_table[],

178

const gchar *str,

179

gint *enum_value_retloc);

180

const gchar* <a class="link" href="gconf-gconf.html#gconf-enum-to-string" title="gconf_enum_to_string ()">gconf_enum_to_string</a> (<a class="link" href="gconf-gconf.html#GConfEnumStringPair" title="GConfEnumStringPair">GConfEnumStringPair</a> lookup_table[],

181

gint enum_value);

182

void <a class="link" href="gconf-gconf.html#gconf-clear-cache" title="gconf_clear_cache ()">gconf_clear_cache</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

183

GError **err);

184

void <a class="link" href="gconf-gconf.html#gconf-synchronous-sync" title="gconf_synchronous_sync ()">gconf_synchronous_sync</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

185

GError **err);

186

<a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a> * <a class="link" href="gconf-gconf.html#gconf-engine-get-full" title="gconf_engine_get_full ()">gconf_engine_get_full</a> (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

187

const gchar *key,

188

const gchar *locale,

189

gboolean use_schema_default,

190

gboolean *is_default_p,

191

gboolean *is_writable_p,

192

GError **err);

176

<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gconf-gconf.html#gconf-string-to-enum" title="gconf_string_to_enum ()">gconf_string_to_enum</a> (<code><a class="link" href="gconf-gconf.html#GConfEnumStringPair" title="GConfEnumStringPair">GConfEnumStringPair</a> lookup_table[]</code>,

177

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *str</code>,

178

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *enum_value_retloc</code>);

179

const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="gconf-gconf.html#gconf-enum-to-string" title="gconf_enum_to_string ()">gconf_enum_to_string</a> (<code><a class="link" href="gconf-gconf.html#GConfEnumStringPair" title="GConfEnumStringPair">GConfEnumStringPair</a> lookup_table[]</code>,

180

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> enum_value</code>);

181

void <a class="link" href="gconf-gconf.html#gconf-clear-cache" title="gconf_clear_cache ()">gconf_clear_cache</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

182

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

183

void <a class="link" href="gconf-gconf.html#gconf-synchronous-sync" title="gconf_synchronous_sync ()">gconf_synchronous_sync</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

184

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

185

<a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a> * <a class="link" href="gconf-gconf.html#gconf-engine-get-full" title="gconf_engine_get_full ()">gconf_engine_get_full</a> (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

186

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

187

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *locale</code>,

188

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> use_schema_default</code>,

189

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> *is_default_p</code>,

190

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> *is_writable_p</code>,

191

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);

193

192

</pre>

194

193

</div>

195

194

202

201

schema names with keys.

203

202

204

203

205

Most of this interface is replicated in the GObject wrapper

204

Most of this interface is replicated in the <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> wrapper

206

205

(GConfClient object); an alternative to the value-setting functions

207

206

is the <a class="link" href="gconf-gconf-changeset.html#GConfChangeSet" title="GConfChangeSet">GConfChangeSet</a> interface.

208

207

211

210

<a name="gconf-gconf.details"></a><h2>Details</h2>

212

211

213

212

<a name="gconf-init"></a><h3>gconf_init ()</h3>

214

<pre class="programlisting">gboolean gconf_init (int argc,

215

char **argv,

216

GError **err);</pre>

213

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_init (<code>int argc</code>,

214

<code>char **argv</code>,

215

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

217

216

218

217

<h3 class="title">Warning</h3>

219

218

<code class="literal">gconf_init</code> is deprecated and should not be used in newly-written code.

238

237

</tr>

239

238

<tr>

240

239

241

<td>the return location for an allocated GError, or NULL to ignore errors.

240

<td>the return location for an allocated <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a>, or NULL to ignore errors.

242

241

</td>

243

242

</tr>

244

243

<tr>

253

252

<hr>

254

253

255

254

<a name="gconf-preinit"></a><h3>gconf_preinit ()</h3>

256

<pre class="programlisting">void gconf_preinit (gpointer app,

257

gpointer mod_info);</pre>

255

<pre class="programlisting">void gconf_preinit (<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> app</code>,

256

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> mod_info</code>);</pre>

258

257

259

258

<h3 class="title">Warning</h3>

260

259

<code class="literal">gconf_preinit</code> is deprecated and should not be used in newly-written code.

280

279

<hr>

281

280

282

281

<a name="gconf-postinit"></a><h3>gconf_postinit ()</h3>

283

<pre class="programlisting">void gconf_postinit (gpointer app,

284

gpointer mod_info);</pre>

282

<pre class="programlisting">void gconf_postinit (<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> app</code>,

283

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> mod_info</code>);</pre>

285

284

286

285

<h3 class="title">Warning</h3>

287

286

<code class="literal">gconf_postinit</code> is deprecated and should not be used in newly-written code.

307

306

<hr>

308

307

309

308

<a name="gconf-is-initialized"></a><h3>gconf_is_initialized ()</h3>

310

<pre class="programlisting">gboolean gconf_is_initialized (void);</pre>

309

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_is_initialized (<code>void</code>);</pre>

311

310

312

311

<h3 class="title">Warning</h3>

313

312

<code class="literal">gconf_is_initialized</code> is deprecated and should not be used in newly-written code.

328

327

<hr>

329

328

330

329

<a name="GConfNotifyFunc"></a><h3>GConfNotifyFunc ()</h3>

331

<pre class="programlisting">void (*GConfNotifyFunc) (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

332

guint cnxn_id,

333

<a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a> *entry,

334

gpointer user_data);</pre>

330

<pre class="programlisting">void (*GConfNotifyFunc) (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

331

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> cnxn_id</code>,

332

<code><a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a> *entry</code>,

333

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

335

334

336

335

A callback function invoked when a key's value changes. The <code>cnxn_id</code> parameter

337

336

will be the connection ID returned from <a class="link" href="gconf-gconf.html#gconf-engine-notify-add" title="gconf_engine_notify_add ()"><code class="function">gconf_engine_notify_add()</code></a>. <code>key</code> will be the

371

370

<hr>

372

371

373

372

<a name="gconf-engine-notify-add"></a><h3>gconf_engine_notify_add ()</h3>

374

<pre class="programlisting">guint gconf_engine_notify_add (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

375

const gchar *namespace_section,

376

<a class="link" href="gconf-gconf.html#GConfNotifyFunc" title="GConfNotifyFunc ()">GConfNotifyFunc</a> func,

377

gpointer user_data,

378

GError **err);</pre>

373

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> gconf_engine_notify_add (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

374

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *namespace_section</code>,

375

<code><a class="link" href="gconf-gconf.html#GConfNotifyFunc" title="GConfNotifyFunc ()">GConfNotifyFunc</a> func</code>,

376

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

377

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

379

378

380

379

Registers a notification request with the gconfd

381

380

server. The server will notify the client when any key at or below

382

381

<code>namespace_section</code> is set or unset. Try to watch the smallest possible part of

383

382

the namespace; otherwise you will slow down the server and your application with

384

unnecessary notifications. Note that you should prefer <a class="link" href="gconf-GConfClient.html#gconf-client-notify-add" title="gconf_client_notify_add ()"><code class="function">gconf_client_notify_add()</code></a>

385

if you're using the GObject wrapper library, because

386

<a class="link" href="gconf-GConfClient.html#gconf-client-notify-add" title="gconf_client_notify_add ()"><code class="function">gconf_client_notify_add()</code></a> does not require a client-server conversation for

383

unnecessary notifications. Note that you should prefer <a class="link" href="gconf-gconf-client.html#gconf-client-notify-add" title="gconf_client_notify_add ()"><code class="function">gconf_client_notify_add()</code></a>

384

if you're using the <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> wrapper library, because

385

<a class="link" href="gconf-gconf-client.html#gconf-client-notify-add" title="gconf_client_notify_add ()"><code class="function">gconf_client_notify_add()</code></a> does not require a client-server conversation for

387

386

every callback. <a class="link" href="gconf-gconf.html#gconf-engine-notify-add" title="gconf_engine_notify_add ()"><code class="function">gconf_engine_notify_add()</code></a> requests a different server notification for

388

387

every callback. The function returns an ID you can use to remove the

389

388

notification request; 0 is an invalid ID, and is returned if an error occurs.

413

412

</tr>

414

413

<tr>

415

414

416

<td>the return location for an allocated GError, or NULL to ignore errors.

415

417

416

</td>

418

417

</tr>

419

418

<tr>

427

426

<hr>

428

427

429

428

<a name="gconf-engine-notify-remove"></a><h3>gconf_engine_notify_remove ()</h3>

430

<pre class="programlisting">void gconf_engine_notify_remove (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

431

guint cnxn);</pre>

429

<pre class="programlisting">void gconf_engine_notify_remove (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

430

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> cnxn</code>);</pre>

432

431

433

432

Removes a notification request.

434

433

451

450

<hr>

452

451

453

452

<a name="gconf-engine-get"></a><h3>gconf_engine_get ()</h3>

454

<pre class="programlisting"><a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* gconf_engine_get (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

455

const gchar *key,

456

GError **err);</pre>

453

<pre class="programlisting"><a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* gconf_engine_get (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

454

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

455

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

457

456

458

457

Returns the <a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a> stored at <code>key</code>, or NULL if no value is

459

458

set. You must call <a class="link" href="gconf-gconf-value.html#gconf-value-free" title="gconf_value_free ()"><code class="function">gconf_value_free()</code></a> to free the returned value. If you know

477

476

</tr>

478

477

<tr>

479

478

480

<td>the return location for an allocated GError, or NULL to ignore errors.

479

481

480

</td>

482

481

</tr>

483

482

<tr>

491

490

<hr>

492

491

493

492

<a name="gconf-engine-get-without-default"></a><h3>gconf_engine_get_without_default ()</h3>

494

<pre class="programlisting"><a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* gconf_engine_get_without_default (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

495

const gchar *key,

496

GError **err);</pre>

493

<pre class="programlisting"><a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* gconf_engine_get_without_default (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

494

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

495

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

497

496

498

497

Identical to <a class="link" href="gconf-gconf.html#gconf-engine-get" title="gconf_engine_get ()"><code class="function">gconf_engine_get()</code></a>, except that it will return NULL in

499

498

place of the default value if the key is unset. Note that <a class="link" href="gconf-gconf.html#gconf-engine-get" title="gconf_engine_get ()"><code class="function">gconf_engine_get()</code></a> can also

514

513

</tr>

515

514

<tr>

516

515

517

<td>the return location for an allocated GError, or NULL to ignore errors.

516

518

517

</td>

519

518

</tr>

520

519

<tr>

528

527

<hr>

529

528

530

529

<a name="gconf-engine-get-entry"></a><h3>gconf_engine_get_entry ()</h3>

531

<pre class="programlisting"><a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a>* gconf_engine_get_entry (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

532

const gchar *key,

533

const gchar *locale,

534

gboolean use_schema_default,

535

GError **err);</pre>

530

<pre class="programlisting"><a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a>* gconf_engine_get_entry (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

531

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

532

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *locale</code>,

533

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> use_schema_default</code>,

534

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

536

535

537

536

Obtain the full <a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a> for a value.

538

537

556

555

</tr>

557

556

<tr>

558

557

<td><code>use_schema_default</code> :</td>

559

<td>a gboolean value indicating whether the default value associated with schema

558

<td>a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> value indicating whether the default value associated with schema

560

559

should be used.

561

560

</td>

562

561

</tr>

563

562

<tr>

564

563

565

<td>the return location for an allocated GError, or NULL to ignore errors.

564

566

565

</td>

567

566

</tr>

568

567

<tr>

576

575

<hr>

577

576

578

577

<a name="gconf-engine-get-with-locale"></a><h3>gconf_engine_get_with_locale ()</h3>

579

<pre class="programlisting"><a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* gconf_engine_get_with_locale (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

580

const gchar *key,

581

const gchar *locale,

582

GError **err);</pre>

578

<pre class="programlisting"><a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* gconf_engine_get_with_locale (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

579

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

580

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *locale</code>,

581

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

583

582

584

583

Requests the value appropriate for a particular locale. Right now,

585

584

only values of type <a class="link" href="gconf-gconf-value.html#GCONF-VALUE-SCHEMA:CAPS"><code class="literal">GCONF_VALUE_SCHEMA</code></a> are localized; the locale is

609

608

</tr>

610

609

<tr>

611

610

612

<td>the return location for an allocated GError, or NULL to ignore errors.

611

613

612

</td>

614

613

</tr>

615

614

<tr>

624

623

625

624

<a name="gconf-engine-get-default-from-schema"></a><h3>gconf_engine_get_default_from_schema ()</h3>

626

625

<pre class="programlisting"><a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>* gconf_engine_get_default_from_schema

627

(<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

628

const gchar *key,

629

GError **err);</pre>

626

(<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

627

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

628

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

630

629

631

630

Returns the default value stored in the key's schema, if the key has a schema

632

631

associated and the schema exists and the schema contains a default value. Note

651

650

</tr>

652

651

<tr>

653

652

654

<td>the return location for an allocated GError, or NULL to ignore errors.

653

655

654

</td>

656

655

</tr>

657

656

<tr>

665

664

<hr>

666

665

667

666

<a name="gconf-engine-set"></a><h3>gconf_engine_set ()</h3>

668

<pre class="programlisting">gboolean gconf_engine_set (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

669

const gchar *key,

670

const <a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a> *value,

671

GError **err);</pre>

667

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_set (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

668

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

669

<code>const <a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a> *value</code>,

670

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

672

671

673

672

Sets the value of <code>key</code> to <code>value</code>. Does not modify the passed-in

674

673

<a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a>, you must free it yourself. You may prefer a type-specific

701

700

</tr>

702

701

<tr>

703

702

704

<td>the return location for an allocated GError, or NULL to ignore errors.

703

705

704

</td>

706

705

</tr>

707

706

<tr>

716

715

<hr>

717

716

718

717

<a name="gconf-engine-unset"></a><h3>gconf_engine_unset ()</h3>

719

<pre class="programlisting">gboolean gconf_engine_unset (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

720

const gchar *key,

721

GError **err);</pre>

718

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_unset (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

719

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

720

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

722

721

723

722

Unsets the value of <code>key</code>; if <code>key</code> is already unset, has no effect. An

724

723

error of note is <code class="literal">GCONF_OVERRIDDEN</code>, indicating that the system

739

738

</tr>

740

739

<tr>

741

740

742

<td>the return location for an allocated GError, or NULL to ignore errors.

741

743

742

</td>

744

743

</tr>

745

744

<tr>

754

753

<hr>

755

754

756

755

<a name="gconf-engine-associate-schema"></a><h3>gconf_engine_associate_schema ()</h3>

757

<pre class="programlisting">gboolean gconf_engine_associate_schema (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

758

const gchar *key,

759

const gchar *schema_key,

760

GError **err);</pre>

756

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_associate_schema (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

757

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

758

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *schema_key</code>,

759

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

761

760

762

761

Directs GConf to find the schema for <code>key</code> at location

763

762

<code>schema_key</code>. That is, the value stored at <code>schema_key</code> should have type

786

785

</tr>

787

786

<tr>

788

787

789

<td>the return location for an allocated GError, or NULL to ignore errors.

788

790

789

</td>

791

790

</tr>

792

791

<tr>

801

800

<hr>

802

801

803

802

<a name="gconf-engine-all-entries"></a><h3>gconf_engine_all_entries ()</h3>

804

<pre class="programlisting">GSList* gconf_engine_all_entries (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

805

const gchar *dir,

806

GError **err);</pre>

803

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList">GSList</a>* gconf_engine_all_entries (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

804

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

805

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

807

806

808

807

Lists the key-value pairs in <code>dir</code>. Does not list subdirectories; for

809

808

that use <a class="link" href="gconf-gconf.html#gconf-engine-all-dirs" title="gconf_engine_all_dirs ()"><code class="function">gconf_engine_all_dirs()</code></a>. The returned list contains <a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a>

810

809

objects. A <a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a> contains an absolute key

811

810

and a value. The list is not recursive, it contains only the immediate

812

811

children of <code>dir</code>. To free the returned list, <a class="link" href="gconf-gconf-value.html#gconf-entry-free" title="gconf_entry_free ()"><code class="function">gconf_entry_free()</code></a>

813

each list element, then <code class="function">g_slist_free()</code> the list itself.

812

each list element, then <a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a> the list itself.

814

813

815

814

816

815

827

826

</tr>

828

827

<tr>

829

828

830

<td>the return location for an allocated GError, or NULL to ignore errors.

829

831

830

</td>

832

831

</tr>

833

832

<tr>

841

840

<hr>

842

841

843

842

<a name="gconf-engine-all-dirs"></a><h3>gconf_engine_all_dirs ()</h3>

844

<pre class="programlisting">GSList* gconf_engine_all_dirs (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

845

const gchar *dir,

846

GError **err);</pre>

843

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList">GSList</a>* gconf_engine_all_dirs (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

844

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

845

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

847

846

848

847

Lists the subdirectories in <code>dir</code>. The returned list contains allocated

849

strings. Each string is the absolute path of a subdirectory. You should <code class="function">g_free()</code> each string in the list, then <code class="function">g_slist_free()</code> the list itself.

848

strings. Each string is the absolute path of a subdirectory. You should <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> each string in the list, then <a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a> the list itself.

850

849

851

850

852

851

863

862

</tr>

864

863

<tr>

865

864

866

<td>the return location for an allocated GError, or NULL to ignore errors.

865

867

866

</td>

868

867

</tr>

869

868

<tr>

877

876

<hr>

878

877

879

878

<a name="gconf-engine-suggest-sync"></a><h3>gconf_engine_suggest_sync ()</h3>

880

<pre class="programlisting">void gconf_engine_suggest_sync (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

881

GError **err);</pre>

879

<pre class="programlisting">void gconf_engine_suggest_sync (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

880

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

882

881

883

882

Suggests to gconfd that you've just finished

884

883

a block of changes, and it would be an optimal time to sync to

898

897

</tr>

899

898

<tr>

900

899

901

<td>the return location for an allocated GError, or NULL to ignore errors.

900

902

901

</td>

903

902

</tr>

904

903

</tbody>

907

906

<hr>

908

907

909

908

<a name="gconf-engine-dir-exists"></a><h3>gconf_engine_dir_exists ()</h3>

910

<pre class="programlisting">gboolean gconf_engine_dir_exists (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

911

const gchar *dir,

912

GError **err);</pre>

909

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_dir_exists (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

910

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

911

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

913

912

914

913

Queries whether the directory <code>dir</code> exists in the GConf

915

914

database. Returns TRUE or FALSE.

929

928

</tr>

930

929

<tr>

931

930

932

<td>the return location for an allocated GError, or NULL to ignore errors.

931

933

932

</td>

934

933

</tr>

935

934

<tr>

944

943

<hr>

945

944

946

945

<a name="gconf-engine-remove-dir"></a><h3>gconf_engine_remove_dir ()</h3>

947

<pre class="programlisting">void gconf_engine_remove_dir (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

948

const gchar *dir,

949

GError **err);</pre>

946

<pre class="programlisting">void gconf_engine_remove_dir (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

947

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

948

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

950

949

951

950

This function first checks the validity of the gconf key. In case of a local <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> it removes

952

951

the directory from the source backend calling <a class="link" href="gconf-gconf-sources.html#gconf-sources-remove-dir" title="gconf_sources_remove_dir ()"><code class="function">gconf_sources_remove_dir()</code></a>. Otherwise it obtains the

968

967

</tr>

969

968

<tr>

970

969

971

<td>the return location for an allocated GError, or NULL to ignore errors.

970

972

971

</td>

973

972

</tr>

974

973

</tbody>

977

976

<hr>

978

977

979

978

<a name="gconf-engine-key-is-writable"></a><h3>gconf_engine_key_is_writable ()</h3>

980

<pre class="programlisting">gboolean gconf_engine_key_is_writable (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

981

const gchar *key,

982

GError **err);</pre>

979

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_key_is_writable (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

980

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

981

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

983

982

984

983

Checks whether the key is writable.

985

984

998

997

</tr>

999

998

<tr>

1000

999

1001

<td>the return location for an allocated GError, or NULL to ignore errors.

1000

1002

1001

</td>

1003

1002

</tr>

1004

1003

<tr>

1013

1012

<hr>

1014

1013

1015

1014

<a name="gconf-valid-key"></a><h3>gconf_valid_key ()</h3>

1016

<pre class="programlisting">gboolean gconf_valid_key (const gchar *key,

1017

gchar **why_invalid);</pre>

1015

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_valid_key (<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1016

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> **why_invalid</code>);</pre>

1018

1017

1019

1018

Asks whether a key is syntactically correct, that is, it ensures that

1020

1019

the key consists of slash-separated strings and contains only legal

1036

1035

</tr>

1037

1036

<tr>

1038

1037

<td><code>why_invalid</code> :</td>

1039

<td>return location for an explanation of the problem, if any. <code class="function">g_free()</code> the returned string.

1038

<td>return location for an explanation of the problem, if any. <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> the returned string.

1040

1039

</td>

1041

1040

</tr>

1042

1041

<tr>

1051

1050

<hr>

1052

1051

1053

1052

<a name="gconf-key-is-below"></a><h3>gconf_key_is_below ()</h3>

1054

<pre class="programlisting">gboolean gconf_key_is_below (const gchar *above,

1055

const gchar *below);</pre>

1053

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_key_is_below (<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *above</code>,

1054

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *below</code>);</pre>

1056

1055

1057

1056

Asks whether the key <code>below</code> would be found below the key <code>above</code>, were

1058

1057

they both to exist in the database. For example, /foo

1085

1084

<hr>

1086

1085

1087

1086

<a name="gconf-concat-dir-and-key"></a><h3>gconf_concat_dir_and_key ()</h3>

1088

<pre class="programlisting">gchar* gconf_concat_dir_and_key (const gchar *dir,

1089

const gchar *key);</pre>

1087

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>* gconf_concat_dir_and_key (<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

1088

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>);</pre>

1090

1089

1091

1090

Concatenates the dir and key passed removing the unnecessary '/' characters

1092

1091

and returns the new string.

1115

1114

<hr>

1116

1115

1117

1116

<a name="gconf-unique-key"></a><h3>gconf_unique_key ()</h3>

1118

<pre class="programlisting">gchar* gconf_unique_key (void);</pre>

1117

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>* gconf_unique_key (<code>void</code>);</pre>

1119

1118

1120

1119

Generates a new and unique key using serial number, process id, current time and a

1121

1120

random number generated.

1124

1123

1125

1124

1126

1125

<td>Returns :</td>

1127

<td>a newly created key, a gchar value.

1126

<td>a newly created key, a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> value.

1128

1127

</td>

1129

1128

</tr></tbody>

1130

1129

</table></div>

1132

1131

<hr>

1133

1132

1134

1133

<a name="gconf-escape-key"></a><h3>gconf_escape_key ()</h3>

1135

<pre class="programlisting">char* gconf_escape_key (const char *arbitrary_text,

1136

int len);</pre>

1134

<pre class="programlisting">char* gconf_escape_key (<code>const char *arbitrary_text</code>,

1135

1137

1136

1138

1137

Escape <code>arbitrary_text</code> such that it's a valid key element (i.e. one

1139

1138

part of the key path). The escaped key won't pass <a class="link" href="gconf-gconf.html#gconf-valid-key" title="gconf_valid_key ()"><code class="function">gconf_valid_key()</code></a>

1140

1139

because it isn't a whole key (i.e. it doesn't have a preceding

1141

1140

slash), but prepending a slash to the escaped text should always

1142

result in a valid key.

1141

result in a valid key.

1142

1143

1144

1145

<tbody>

1146

<tr>

1147

<td><code>arbitrary_text</code> :</td>

1148

<td> some text in any encoding or format

1148

<td>some text in any encoding or format

1149

</td>

1150

</tr>

1151

<tr>

1152

1153

<td> length of <code>arbitrary_text</code> in bytes, or -1 if <code>arbitrary_text</code> is nul-terminated

1153

<td>length of <code>arbitrary_text</code> in bytes, or -1 if <code>arbitrary_text</code> is nul-terminated

1154

</td>

1155

</tr>

1156

<tr>

1164

<hr>

1165

1166

<a name="gconf-unescape-key"></a><h3>gconf_unescape_key ()</h3>

1167

<pre class="programlisting">char* gconf_unescape_key (const char *escaped_key,

1168

int len);</pre>

1167

<pre class="programlisting">char* gconf_unescape_key (<code>const char *escaped_key</code>,

1168

1169

1170

Converts a string escaped with <a class="link" href="gconf-gconf.html#gconf-escape-key" title="gconf_escape_key ()"><code class="function">gconf_escape_key()</code></a> back into its original

1171

form.

1171

form.

1172

1172

1173

1173

1174

1174

1175

<tbody>

1175

1176

<tr>

1176

1177

<td><code>escaped_key</code> :</td>

1177

<td> a key created with <a class="link" href="gconf-gconf.html#gconf-escape-key" title="gconf_escape_key ()"><code class="function">gconf_escape_key()</code></a>

1178

<td>a key created with <a class="link" href="gconf-gconf.html#gconf-escape-key" title="gconf_escape_key ()"><code class="function">gconf_escape_key()</code></a>

1178

1179

</td>

1179

1180

</tr>

1180

1181

<tr>

1181

1182

1182

<td> length of <code>escaped_key</code> in bytes, or -1 if <code>escaped_key</code> is nul-terminated

1183

<td>length of <code>escaped_key</code> in bytes, or -1 if <code>escaped_key</code> is nul-terminated

1183

1184

</td>

1184

1185

</tr>

1185

1186

<tr>

1193

1194

<hr>

1194

1195

1195

1196

<a name="gconf-engine-get-float"></a><h3>gconf_engine_get_float ()</h3>

1196

<pre class="programlisting">gdouble gconf_engine_get_float (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1197

const gchar *key,

1198

GError **err);</pre>

1197

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a> gconf_engine_get_float (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1198

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1199

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1199

1200

1200

1201

Requests the floating point number (<a class="link" href="gconf-gconf-value.html#GCONF-VALUE-FLOAT:CAPS"><code class="literal">GCONF_VALUE_FLOAT</code></a>) stored at

1201

1202

<code>key</code>. Automatically performs type-checking, so if a non-float is

1217

1218

</tr>

1218

1219

<tr>

1219

1220

1220

<td>the return location for an allocated GError, or NULL to ignore errors.

1221

1222

</td>

1222

1223

</tr>

1223

1224

<tr>

1231

1232

<hr>

1232

1233

1233

1234

<a name="gconf-engine-get-int"></a><h3>gconf_engine_get_int ()</h3>

1234

<pre class="programlisting">gint gconf_engine_get_int (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1235

const gchar *key,

1236

GError **err);</pre>

1235

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> gconf_engine_get_int (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1236

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1237

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1237

1238

1238

1239

Requests the integer (<a class="link" href="gconf-gconf-value.html#GCONF-VALUE-INT:CAPS"><code class="literal">GCONF_VALUE_INT</code></a>) stored at

1239

1240

<code>key</code>. Automatically performs type-checking, so if a non-integer is

1255

1256

</tr>

1256

1257

<tr>

1257

1258

1258

<td>the return location for an allocated GError, or NULL to ignore errors.

1259

1260

</td>

1260

1261

</tr>

1261

1262

<tr>

1269

1270

<hr>

1270

1271

1271

1272

<a name="gconf-engine-get-string"></a><h3>gconf_engine_get_string ()</h3>

1272

<pre class="programlisting">gchar* gconf_engine_get_string (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1273

const gchar *key,

1274

GError **err);</pre>

1273

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>* gconf_engine_get_string (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1274

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1275

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1275

1276

1276

1277

Requests the string (<a class="link" href="gconf-gconf-value.html#GCONF-VALUE-STRING:CAPS"><code class="literal">GCONF_VALUE_STRING</code></a>) stored at

1277

1278

<code>key</code>. Automatically performs type-checking, so if a non-string is

1293

1294

</tr>

1294

1295

<tr>

1295

1296

1296

<td>the return location for an allocated GError, or NULL to ignore errors.

1297

1298

</td>

1298

1299

</tr>

1299

1300

<tr>

1307

1308

<hr>

1308

1309

1309

1310

<a name="gconf-engine-get-bool"></a><h3>gconf_engine_get_bool ()</h3>

1310

<pre class="programlisting">gboolean gconf_engine_get_bool (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1311

const gchar *key,

1312

GError **err);</pre>

1311

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_get_bool (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1312

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1313

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1313

1314

1314

1315

Requests the boolean value (<a class="link" href="gconf-gconf-value.html#GCONF-VALUE-BOOL:CAPS"><code class="literal">GCONF_VALUE_BOOL</code></a>) stored at

1315

1316

<code>key</code>. Automatically performs type-checking, so if a non-bool is

1331

1332

</tr>

1332

1333

<tr>

1333

1334

1334

<td>the return location for an allocated GError, or NULL to ignore errors.

1335

1336

</td>

1336

1337

</tr>

1337

1338

<tr>

1345

1346

<hr>

1346

1347

1347

1348

<a name="gconf-engine-get-schema"></a><h3>gconf_engine_get_schema ()</h3>

1348

<pre class="programlisting"><a class="link" href="gconf-gconf-schema.html#GConfSchema" title="GConfSchema">GConfSchema</a>* gconf_engine_get_schema (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1349

const gchar *key,

1350

GError **err);</pre>

1349

<pre class="programlisting"><a class="link" href="gconf-gconf-schema.html#GConfSchema" title="GConfSchema">GConfSchema</a>* gconf_engine_get_schema (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1350

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1351

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1351

1352

1352

1353

Requests the schema (<a class="link" href="gconf-gconf-value.html#GCONF-VALUE-SCHEMA:CAPS"><code class="literal">GCONF_VALUE_SCHEMA</code></a>) stored at <code>key</code>.

1353

1354

Automatically performs type-checking, so if a non-schema is stored at

1369

1370

</tr>

1370

1371

<tr>

1371

1372

1372

<td>the return location for an allocated GError, or NULL to ignore errors.

1373

1374

</td>

1374

1375

</tr>

1375

1376

<tr>

1383

1384

<hr>

1384

1385

1385

1386

<a name="gconf-engine-get-list"></a><h3>gconf_engine_get_list ()</h3>

1386

<pre class="programlisting">GSList* gconf_engine_get_list (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1387

const gchar *key,

1388

<a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> list_type,

1389

GError **err);</pre>

1387

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList">GSList</a>* gconf_engine_get_list (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1388

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1389

<code><a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> list_type</code>,

1390

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1390

1391

1391

1392

Requests the list (<a class="link" href="gconf-gconf-value.html#GCONF-VALUE-LIST:CAPS"><code class="literal">GCONF_VALUE_LIST</code></a>) stored at <code>key</code>. Automatically

1392

1393

performs type-checking, so if a non-list is stored at <code>key</code>, or the

1417

1418

<tbody>

1418

1419

<tr>

1419

1420

<td><a class="link" href="gconf-gconf-value.html#GCONF-VALUE-INT:CAPS"><code class="literal">GCONF_VALUE_INT</code></a></td>

1420

<td>The integer itself, converted with <code class="function">GINT_TO_POINTER()</code>

1421

<td>The integer itself, converted with <a href="/usr/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html#GINT-TO-POINTER:CAPS"><code class="function">GINT_TO_POINTER()</code></a>

1421

1422

</td>

1422

1423

</tr>

1423

1424

<tr>

1424

1425

<td><a class="link" href="gconf-gconf-value.html#GCONF-VALUE-BOOL:CAPS"><code class="literal">GCONF_VALUE_BOOL</code></a></td>

1425

<td>The bool itself, converted with <code class="function">GINT_TO_POINTER()</code>

1426

<td>The bool itself, converted with <a href="/usr/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html#GINT-TO-POINTER:CAPS"><code class="function">GINT_TO_POINTER()</code></a>

1426

1427

</td>

1427

1428

</tr>

1428

1429

<tr>

1429

1430

<td><a class="link" href="gconf-gconf-value.html#GCONF-VALUE-FLOAT:CAPS"><code class="literal">GCONF_VALUE_FLOAT</code></a></td>

1430

<td>A pointer to gdouble, which should be freed with <code class="function">g_free()</code>

1431

<td>A pointer to <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a>, which should be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

1431

1432

</td>

1432

1433

</tr>

1433

1434

<tr>

1434

1435

<td><a class="link" href="gconf-gconf-value.html#GCONF-VALUE-STRING:CAPS"><code class="literal">GCONF_VALUE_STRING</code></a></td>

1435

<td>A pointer to gchar, which should be freed with <code class="function">g_free()</code>

1436

<td>A pointer to <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>, which should be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

1436

1437

</td>

1437

1438

</tr>

1438

1439

<tr>

1444

1445

</table></div>

1445

1446

1446

1447

In the <a class="link" href="gconf-gconf-value.html#GCONF-VALUE-FLOAT:CAPS"><code class="literal">GCONF_VALUE_FLOAT</code></a> and <a class="link" href="gconf-gconf-value.html#GCONF-VALUE-STRING:CAPS"><code class="literal">GCONF_VALUE_STRING</code></a> cases, you must

1447

<code class="function">g_free()</code> each list element. In the <a class="link" href="gconf-gconf-value.html#GCONF-VALUE-SCHEMA:CAPS"><code class="literal">GCONF_VALUE_SCHEMA</code></a> case you must

1448

<a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> each list element. In the <a class="link" href="gconf-gconf-value.html#GCONF-VALUE-SCHEMA:CAPS"><code class="literal">GCONF_VALUE_SCHEMA</code></a> case you must

1448

1449

<a class="link" href="gconf-gconf-schema.html#gconf-schema-free" title="gconf_schema_free ()"><code class="function">gconf_schema_free()</code></a> each element. In all cases you must free the

1449

list itself with <code class="function">g_slist_free()</code>.

1450

list itself with <a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>.

1450

1451

1451

1452

1452

1453

1468

1469

</tr>

1469

1470

<tr>

1470

1471

1471

<td>the return location for an allocated GError, or NULL to ignore errors.

1472

1473

</td>

1473

1474

</tr>

1474

1475

<tr>

1482

1483

<hr>

1483

1484

1484

1485

<a name="gconf-engine-get-pair"></a><h3>gconf_engine_get_pair ()</h3>

1485

<pre class="programlisting">gboolean gconf_engine_get_pair (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1486

const gchar *key,

1487

<a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> car_type,

1488

<a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> cdr_type,

1489

gpointer car_retloc,

1490

gpointer cdr_retloc,

1491

GError **err);</pre>

1486

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_get_pair (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1487

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1488

<code><a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> car_type</code>,

1489

<code><a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> cdr_type</code>,

1490

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> car_retloc</code>,

1491

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> cdr_retloc</code>,

1492

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1492

1493

1493

1494

Requests the pair (<a class="link" href="gconf-gconf-value.html#GCONF-VALUE-PAIR:CAPS"><code class="literal">GCONF_VALUE_PAIR</code></a>) stored at <code>key</code>. Automatically

1494

1495

performs type-checking, so if a non-pair is stored at <code>key</code>, or the

1515

1516

<tbody>

1516

1517

<tr>

1517

1518

<td><a class="link" href="gconf-gconf-value.html#GCONF-VALUE-INT:CAPS"><code class="literal">GCONF_VALUE_INT</code></a></td>

1518

<td>pointer to gint

1519

<td>pointer to <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a>

1519

1520

</td>

1520

1521

</tr>

1521

1522

<tr>

1522

1523

<td><a class="link" href="gconf-gconf-value.html#GCONF-VALUE-BOOL:CAPS"><code class="literal">GCONF_VALUE_BOOL</code></a></td>

1523

<td>pointer to gboolean

1524

<td>pointer to <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a>

1524

1525

</td>

1525

1526

</tr>

1526

1527

<tr>

1527

1528

<td><a class="link" href="gconf-gconf-value.html#GCONF-VALUE-FLOAT:CAPS"><code class="literal">GCONF_VALUE_FLOAT</code></a></td>

1528

<td>pointer to gdouble

1529

<td>pointer to <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a>

1529

1530

</td>

1530

1531

</tr>

1531

1532

<tr>

1532

1533

<td><a class="link" href="gconf-gconf-value.html#GCONF-VALUE-STRING:CAPS"><code class="literal">GCONF_VALUE_STRING</code></a></td>

1533

<td>pointer to gchar*</td>

1534

<td>pointer to <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>*</td>

1534

1535

</tr>

1535

1536

<tr>

1536

1537

<td><a class="link" href="gconf-gconf-value.html#GCONF-VALUE-SCHEMA:CAPS"><code class="literal">GCONF_VALUE_SCHEMA</code></a></td>

1539

1540

</tbody>

1540

1541

</table></div>

1541

1542

1542

In the <a class="link" href="gconf-gconf-value.html#GCONF-VALUE-STRING:CAPS"><code class="literal">GCONF_VALUE_STRING</code></a> case, you must <code class="function">g_free()</code> the string(s)

1543

In the <a class="link" href="gconf-gconf-value.html#GCONF-VALUE-STRING:CAPS"><code class="literal">GCONF_VALUE_STRING</code></a> case, you must <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> the string(s)

1543

1544

stored in the return location(s). In the <a class="link" href="gconf-gconf-value.html#GCONF-VALUE-SCHEMA:CAPS"><code class="literal">GCONF_VALUE_SCHEMA</code></a> case you

1544

1545

must <a class="link" href="gconf-gconf-schema.html#gconf-schema-free" title="gconf_schema_free ()"><code class="function">gconf_schema_free()</code></a> the returned schema. If there's an error

1545

1546

or the value is unset, <code>car_retloc</code> and <code>cdr_retloc</code> are left unchanged.

1612

1613

</tr>

1613

1614

<tr>

1614

1615

1615

<td>the return location for an allocated GError, or NULL to ignore errors.

1616

1617

</td>

1617

1618

</tr>

1618

1619

<tr>

1627

1628

<hr>

1628

1629

1629

1630

<a name="gconf-engine-set-float"></a><h3>gconf_engine_set_float ()</h3>

1630

<pre class="programlisting">gboolean gconf_engine_set_float (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1631

const gchar *key,

1632

gdouble val,

1633

GError **err);</pre>

1631

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_set_float (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1632

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1633

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a> val</code>,

1634

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1634

1635

1635

1636

Change the value of <code>key</code> to <code>val</code>. Automatically creates the <code>key</code> if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but doesn't store a float (GCONF_VALUE_FLOAT), <a class="link" href="gconf-gconf.html#gconf-engine-set-float" title="gconf_engine_set_float ()"><code class="function">gconf_engine_set_float()</code></a> will fail.

1636

1637

1654

1655

</tr>

1655

1656

<tr>

1656

1657

1657

<td>the return location for an allocated GError, or NULL to ignore errors.

1658

1659

</td>

1659

1660

</tr>

1660

1661

<tr>

1669

1670

<hr>

1670

1671

1671

1672

<a name="gconf-engine-set-int"></a><h3>gconf_engine_set_int ()</h3>

1672

<pre class="programlisting">gboolean gconf_engine_set_int (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1673

const gchar *key,

1674

gint val,

1675

GError **err);</pre>

1673

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_set_int (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1674

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1675

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> val</code>,

1676

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1676

1677

1677

1678

Change the value of <code>key</code> to <code>val</code>. Automatically creates the <code>key</code> if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but doesn't store an integer (GCONF_VALUE_INT), <a class="link" href="gconf-gconf.html#gconf-engine-set-int" title="gconf_engine_set_int ()"><code class="function">gconf_engine_set_int()</code></a> will fail.

1678

1679

1696

1697

</tr>

1697

1698

<tr>

1698

1699

1699

<td>the return location for an allocated GError, or NULL to ignore errors.

1700

1701

</td>

1701

1702

</tr>

1702

1703

<tr>

1711

1712

<hr>

1712

1713

1713

1714

<a name="gconf-engine-set-string"></a><h3>gconf_engine_set_string ()</h3>

1714

<pre class="programlisting">gboolean gconf_engine_set_string (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1715

const gchar *key,

1716

const gchar *val,

1717

GError **err);</pre>

1715

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_set_string (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1716

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1717

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *val</code>,

1718

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1718

1719

1719

1720

Change the value of <code>key</code> to <code>val</code>. Automatically creates the <code>key</code> if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but doesn't store a string (GCONF_VALUE_STRING), <a class="link" href="gconf-gconf.html#gconf-engine-set-string" title="gconf_engine_set_string ()"><code class="function">gconf_engine_set_string()</code></a> will fail.

1720

1721

1738

1739

</tr>

1739

1740

<tr>

1740

1741

1741

<td>the return location for an allocated GError, or NULL to ignore errors.

1742

1743

</td>

1743

1744

</tr>

1744

1745

<tr>

1753

1754

<hr>

1754

1755

1755

1756

<a name="gconf-engine-set-bool"></a><h3>gconf_engine_set_bool ()</h3>

1756

<pre class="programlisting">gboolean gconf_engine_set_bool (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1757

const gchar *key,

1758

gboolean val,

1759

GError **err);</pre>

1757

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_set_bool (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1758

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1759

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> val</code>,

1760

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1760

1761

1761

1762

Change the value of <code>key</code> to <code>val</code>. Automatically creates the <code>key</code> if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but but doesn't store a boolean (GCONF_VALUE_BOOL), <a class="link" href="gconf-gconf.html#gconf-engine-set-bool" title="gconf_engine_set_bool ()"><code class="function">gconf_engine_set_bool()</code></a> will fail.

1762

1763

1780

1781

</tr>

1781

1782

<tr>

1782

1783

1783

<td>the return location for an allocated GError, or NULL to ignore errors.

1784

1785

</td>

1785

1786

</tr>

1786

1787

<tr>

1795

1796

<hr>

1796

1797

1797

1798

<a name="gconf-engine-set-schema"></a><h3>gconf_engine_set_schema ()</h3>

1798

<pre class="programlisting">gboolean gconf_engine_set_schema (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1799

const gchar *key,

1800

const <a class="link" href="gconf-gconf-schema.html#GConfSchema" title="GConfSchema">GConfSchema</a> *val,

1801

GError **err);</pre>

1799

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_set_schema (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1800

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1801

<code>const <a class="link" href="gconf-gconf-schema.html#GConfSchema" title="GConfSchema">GConfSchema</a> *val</code>,

1802

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1802

1803

1803

1804

Change the value of <code>key</code> to <code>val</code>. Automatically creates the <code>key</code> if it didn't exist before (ie it was unset or it only had a default value). If the key already exists but doesn't store a schema value (GCONF_VALUE_SCHEMA), <a class="link" href="gconf-gconf.html#gconf-engine-set-schema" title="gconf_engine_set_schema ()"><code class="function">gconf_engine_set_schema()</code></a> will fail.

1804

1805

1822

1823

</tr>

1823

1824

<tr>

1824

1825

1825

<td>the return location for an allocated GError, or NULL to ignore errors.

1826

1827

</td>

1827

1828

</tr>

1828

1829

<tr>

1837

1838

<hr>

1838

1839

1839

1840

<a name="gconf-engine-set-list"></a><h3>gconf_engine_set_list ()</h3>

1840

<pre class="programlisting">gboolean gconf_engine_set_list (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1841

const gchar *key,

1842

<a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> list_type,

1843

GSList *list,

1844

GError **err);</pre>

1841

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_set_list (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1842

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1843

<code><a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> list_type</code>,

1844

<code><a href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList">GSList</a> *list</code>,

1845

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1845

1846

1846

1847

Change the value of <code>key</code> to <code>list</code> of type <code>list_type</code>. Automatically creates the <code>key</code> if it didn't exist before

1847

1848

(ie it was unset or it only had a default value). If the key already exists but doesn't store a list value

1872

1873

</tr>

1873

1874

<tr>

1874

1875

1875

<td>the return location for an allocated GError, or NULL to ignore errors.

1876

1877

</td>

1877

1878

</tr>

1878

1879

<tr>

1887

1888

<hr>

1888

1889

1889

1890

<a name="gconf-engine-set-pair"></a><h3>gconf_engine_set_pair ()</h3>

1890

<pre class="programlisting">gboolean gconf_engine_set_pair (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

1891

const gchar *key,

1892

<a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> car_type,

1893

<a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> cdr_type,

1894

gconstpointer address_of_car,

1895

gconstpointer address_of_cdr,

1896

GError **err);</pre>

1891

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_engine_set_pair (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

1892

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1893

<code><a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> car_type</code>,

1894

<code><a class="link" href="gconf-gconf-value.html#GConfValueType" title="enum GConfValueType">GConfValueType</a> cdr_type</code>,

1895

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gconstpointer">gconstpointer</a> address_of_car</code>,

1896

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gconstpointer">gconstpointer</a> address_of_cdr</code>,

1897

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

1897

1898

1898

1899

Change the value of <code>key</code> to a pair of first type <code>car_type</code> and second type <code>cdr_type</code> . Automatically creates the

1899

1900

<code>key</code> if it didn't exist before (ie it was unset or it only had a default value). If the key already exists

1934

1935

</tr>

1935

1936

<tr>

1936

1937

1937

<td>the return location for an allocated GError, or NULL to ignore errors.

1938

1939

</td>

1939

1940

</tr>

1940

1941

<tr>

1960

1961

<hr>

1961

1962

1962

1963

<a name="gconf-string-to-enum"></a><h3>gconf_string_to_enum ()</h3>

1963

<pre class="programlisting">gboolean gconf_string_to_enum (<a class="link" href="gconf-gconf.html#GConfEnumStringPair" title="GConfEnumStringPair">GConfEnumStringPair</a> lookup_table[],

1964

const gchar *str,

1965

gint *enum_value_retloc);</pre>

1964

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> gconf_string_to_enum (<code><a class="link" href="gconf-gconf.html#GConfEnumStringPair" title="GConfEnumStringPair">GConfEnumStringPair</a> lookup_table[]</code>,

1965

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *str</code>,

1966

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *enum_value_retloc</code>);</pre>

1966

1967

1967

1968

It's best to store enumeration values as strings rather than integers. This is

1968

1969

robust against changes in the enumeration, and also human-readable.

2018

2019

<hr>

2019

2020

2020

2021

<a name="gconf-enum-to-string"></a><h3>gconf_enum_to_string ()</h3>

2021

<pre class="programlisting">const gchar* gconf_enum_to_string (<a class="link" href="gconf-gconf.html#GConfEnumStringPair" title="GConfEnumStringPair">GConfEnumStringPair</a> lookup_table[],

2022

gint enum_value);</pre>

2022

<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>* gconf_enum_to_string (<code><a class="link" href="gconf-gconf.html#GConfEnumStringPair" title="GConfEnumStringPair">GConfEnumStringPair</a> lookup_table[]</code>,

2023

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> enum_value</code>);</pre>

2023

2024

2024

2025

See <a class="link" href="gconf-gconf.html#gconf-string-to-enum" title="gconf_string_to_enum ()"><code class="function">gconf_string_to_enum()</code></a> for background information on this function.

2025

2026

2047

2048

<hr>

2048

2049

2049

2050

<a name="gconf-clear-cache"></a><h3>gconf_clear_cache ()</h3>

2050

<pre class="programlisting">void gconf_clear_cache (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

2051

GError **err);</pre>

2051

<pre class="programlisting">void gconf_clear_cache (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

2052

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

2052

2053

2053

2054

In case of a local <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a>, this function calls <code class="function">gconf_sources_clear_cache()</code> to clear the

2054

2055

cache from the source. Otherwise it obtains the configuration database using <code class="function">gconf_engine_get_database()</code>

2064

2065

</tr>

2065

2066

<tr>

2066

2067

2067

<td>the return location for an allocated GError, or NULL to ignore errors.

2068

2069

</td>

2069

2070

</tr>

2070

2071

</tbody>

2073

2074

<hr>

2074

2075

2075

2076

<a name="gconf-synchronous-sync"></a><h3>gconf_synchronous_sync ()</h3>

2076

<pre class="programlisting">void gconf_synchronous_sync (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

2077

GError **err);</pre>

2077

<pre class="programlisting">void gconf_synchronous_sync (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

2078

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

2078

2079

2079

2080

In case of a local <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a>, this function syncs up all the gconf sources calling

2080

2081

<a class="link" href="gconf-gconf.html#gconf-synchronous-sync" title="gconf_synchronous_sync ()"><code class="function">gconf_synchronous_sync()</code></a>. Otherwise it obtains the configuration database using

2090

2091

</tr>

2091

2092

<tr>

2092

2093

2093

<td>the return location for an allocated GError, or NULL to ignore errors.

2094

2095

</td>

2095

2096

</tr>

2096

2097

</tbody>

2099

2100

<hr>

2100

2101

2101

2102

<a name="gconf-engine-get-full"></a><h3>gconf_engine_get_full ()</h3>

2102

<pre class="programlisting"><a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a> * gconf_engine_get_full (<a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf,

2103

const gchar *key,

2104

const gchar *locale,

2105

gboolean use_schema_default,

2106

gboolean *is_default_p,

2107

gboolean *is_writable_p,

2108

GError **err);</pre>

2103

<pre class="programlisting"><a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a> * gconf_engine_get_full (<code><a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine">GConfEngine</a> *conf</code>,

2104

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

2105

<code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *locale</code>,

2106

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> use_schema_default</code>,

2107

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> *is_default_p</code>,

2108

<code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> *is_writable_p</code>,

2109

<code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

2109

2110

2110

2111

Returns the <a class="link" href="gconf-gconf-value.html#GConfValue" title="GConfValue">GConfValue</a> of a key and the associated <a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a> fields depending on the parameters passed.

2111

2112

2130

2131

</tr>

2131

2132

<tr>

2132

2133

<td><code>use_schema_default</code> :</td>

2133

<td>a gboolean value, indicating whether schema information is to be used as the default

2134

<td>a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> value, indicating whether schema information is to be used as the default

2134

2135

value.

2135

2136

</td>

2136

2137

</tr>

2137

2138

<tr>

2138

2139

<td><code>is_default_p</code> :</td>

2139

<td>a gpointer if the is_default field of the <a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a> is required, NULL

2140

<td>a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> if the is_default field of the <a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a> is required, NULL

2140

2141

otherwise.

2141

2142

</td>

2142

2143

</tr>

2143

2144

<tr>

2144

2145

<td><code>is_writable_p</code> :</td>

2145

<td>a gpointer if the is_writable field of the <a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a> is required, NULL

2146

<td>a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> if the is_writable field of the <a class="link" href="gconf-gconf-value.html#GConfEntry" title="GConfEntry">GConfEntry</a> is required, NULL

2146

2147

otherwise.

2147

2148

</td>

2148

2149

</tr>

2149

2150

<tr>

2150

2151

2151

<td>the return location for an allocated GError, or NULL to ignore errors.

2152

2153

</td>

2153

2154

</tr>

2154

2155

<tr>

Older »