~ubuntu-branches/ubuntu/oneiric/gconf/oneiric-proposed

<pre class="synopsis"><a href="http://library.gnome.org/devel/glib/unstable/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>GError **err</code>);

void <a class="link" href="gconf-gconf.html#gconf-preinit" title="gconf_preinit ()">gconf_preinit</a> (<code>gpointer app</code>,

<code>gpointer mod_info</code>);

void <a class="link" href="gconf-gconf.html#gconf-postinit" title="gconf_postinit ()">gconf_postinit</a> (<code>gpointer app</code>,

<code>gpointer mod_info</code>);

gboolean <a class="link" href="gconf-gconf.html#gconf-is-initialized" title="gconf_is_initialized ()">gconf_is_initialized</a> (<code>void</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> mod_info</code>);

<a href="http://library.gnome.org/devel/glib/unstable/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>guint cnxn_id</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/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>gpointer user_data</code>);

guint <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 gchar *namespace_section</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>gpointer user_data</code>,

<code>GError **err</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/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>guint 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 gchar *key</code>,

<code>GError **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 gchar *key</code>,

<code>GError **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 gchar *key</code>,

<code>const gchar *locale</code>,

<code>gboolean use_schema_default</code>,

<code>GError **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 gchar *key</code>,

<code>const gchar *locale</code>,

<code>GError **err</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *locale</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> use_schema_default</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *locale</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

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

<code>const gchar *key</code>,

<code>GError **err</code>);

gboolean <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 gchar *key</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>GError **err</code>);

gboolean <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 gchar *key</code>,

<code>GError **err</code>);

gboolean <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 gchar *key</code>,

<code>const gchar *schema_key</code>,

<code>GError **err</code>);

GSList* <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 gchar *dir</code>,

<code>GError **err</code>);

GSList* <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 gchar *dir</code>,

<code>GError **err</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *schema_key</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/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>GError **err</code>);

gboolean <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 gchar *dir</code>,

<code>GError **err</code>);

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/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 gchar *dir</code>,

102

<code>GError **err</code>);

103

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

104

<code>const gchar *key</code>,

105

<code>GError **err</code>);

106

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

107

<code>gchar **why_invalid</code>);

108

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

109

<code>const gchar *below</code>);

110

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> (<code>const gchar *dir</code>,

111

<code>const gchar *key</code>);

112

gchar* <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

gdouble <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 gchar *key</code>,

119

<code>GError **err</code>);

120

gint <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 gchar *key</code>,

122

<code>GError **err</code>);

123

gchar* <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 gchar *key</code>,

125

<code>GError **err</code>);

126

gboolean <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 gchar *key</code>,

128

<code>GError **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 gchar *key</code>,

131

<code>GError **err</code>);

132

GSList* <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 gchar *key</code>,

101

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

102

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

103

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

105

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

106

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

107

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **why_invalid</code>);

108

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *above</code>,

109

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *below</code>);

110

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

111

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>);

112

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

119

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

120

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

122

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

123

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

125

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

126

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

128

<code><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

131

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

132

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>GError **err</code>);

136

gboolean <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 gchar *key</code>,

135

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

136

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>gpointer car_retloc</code>,

141

<code>gpointer cdr_retloc</code>,

142

<code>GError **err</code>);

143

gboolean <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 gchar *key</code>,

145

<code>gdouble val</code>,

146

<code>GError **err</code>);

147

gboolean <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 gchar *key</code>,

149

<code>gint val</code>,

150

<code>GError **err</code>);

151

gboolean <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 gchar *key</code>,

153

<code>const gchar *val</code>,

154

<code>GError **err</code>);

155

gboolean <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 gchar *key</code>,

157

<code>gboolean val</code>,

158

<code>GError **err</code>);

159

gboolean <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 gchar *key</code>,

140

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> car_retloc</code>,

141

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> cdr_retloc</code>,

142

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

143

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

145

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble">gdouble</a> val</code>,

146

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

147

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

149

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> val</code>,

150

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

151

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

153

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *val</code>,

154

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

155

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

157

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> val</code>,

158

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

159

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>GError **err</code>);

163

gboolean <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 gchar *key</code>,

162

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

163

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>GSList *list</code>,

167

<code>GError **err</code>);

168

gboolean <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 gchar *key</code>,

166

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList">GSList</a> *list</code>,

167

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

168

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>gconstpointer address_of_car</code>,

173

<code>gconstpointer address_of_cdr</code>,

174

<code>GError **err</code>);

172

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer">gconstpointer</a> address_of_car</code>,

173

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer">gconstpointer</a> address_of_cdr</code>,

174

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

175

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

176

gboolean <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 gchar *str</code>,

178

<code>gint *enum_value_retloc</code>);

179

const gchar* <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>gint enum_value</code>);

176

<a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *str</code>,

178

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *enum_value_retloc</code>);

179

const <a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>GError **err</code>);

182

<code><a href="http://library.gnome.org/devel/glib/unstable/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>GError **err</code>);

184

<code><a href="http://library.gnome.org/devel/glib/unstable/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 gchar *key</code>,

187

<code>const gchar *locale</code>,

188

<code>gboolean use_schema_default</code>,

189

<code>gboolean *is_default_p</code>,

190

<code>gboolean *is_writable_p</code>,

191

<code>GError **err</code>);

186

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

187

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *locale</code>,

188

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> use_schema_default</code>,

189

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> *is_default_p</code>,

190

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> *is_writable_p</code>,

191

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);

192

</pre>

193

</div>

194

201

schema names with keys.

202

203

204

Most of this interface is replicated in the GObject wrapper

204

Most of this interface is replicated in the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> wrapper

205

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

206

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

207

210

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

211

212

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

213

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

213

214

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

215

<code>GError **err</code>);</pre>

215

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

216

217

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

218

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

237

</tr>

238

<tr>

239

240

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

240

<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or NULL to ignore errors.

241

</td>

242

</tr>

243

<tr>

252

<hr>

253

254

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

255

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

256

<code>gpointer mod_info</code>);</pre>

255

<pre class="programlisting">void gconf_preinit (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> app</code>,

256

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> mod_info</code>);</pre>

257

258

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

259

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

279

<hr>

280

281

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

282

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

283

<code>gpointer mod_info</code>);</pre>

282

<pre class="programlisting">void gconf_postinit (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> app</code>,

283

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> mod_info</code>);</pre>

284

285

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

286

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

306

<hr>

307

308

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

309

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

309

310

311

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

312

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

328

329

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

330

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

331

<code>guint cnxn_id</code>,

331

<code><a href="http://library.gnome.org/devel/glib/unstable/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>gpointer user_data</code>);</pre>

333

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

334

335

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

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

370

<hr>

371

372

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

373

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

374

<code>const gchar *namespace_section</code>,

373

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>gpointer user_data</code>,

377

<code>GError **err</code>);</pre>

376

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

377

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

378

379

Registers a notification request with the gconfd

380

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

381

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

382

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

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 GObject wrapper library, because

384

if you're using the <a href="http://library.gnome.org/devel/gobject/unstable/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

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

387

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

412

</tr>

413

<tr>

414

415

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

415

416

</td>

417

</tr>

418

<tr>

427

428

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

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>guint cnxn</code>);</pre>

430

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> cnxn</code>);</pre>

431

432

Removes a notification request.

433

450

<hr>

451

452

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

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 gchar *key</code>,

455

<code>GError **err</code>);</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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

455

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

456

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

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

476

</tr>

477

<tr>

478

479

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

479

480

</td>

481

</tr>

482

<tr>

490

<hr>

491

492

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

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 gchar *key</code>,

495

<code>GError **err</code>);</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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

495

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

496

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

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

513

</tr>

514

<tr>

515

516

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

516

517

</td>

518

</tr>

519

<tr>

527

<hr>

528

529

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

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 gchar *key</code>,

532

<code>const gchar *locale</code>,

533

<code>gboolean use_schema_default</code>,

534

<code>GError **err</code>);</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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

532

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *locale</code>,

533

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> use_schema_default</code>,

534

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

535

536

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

537

555

</tr>

556

<tr>

557

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

558

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

558

<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> value indicating whether the default value associated with schema

559

should be used.

560

</td>

561

</tr>

562

<tr>

563

564

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

564

565

</td>

566

</tr>

567

<tr>

575

<hr>

576

577

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

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 gchar *key</code>,

580

<code>const gchar *locale</code>,

581

<code>GError **err</code>);</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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

580

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *locale</code>,

581

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

582

583

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

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

608

</tr>

609

<tr>

610

611

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

611

612

</td>

613

</tr>

614

<tr>

622

<hr>

623

624

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

625

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

625

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

626

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

627

<code>const gchar *key</code>,

628

<code>GError **err</code>);</pre>

627

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

628

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

629

630

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

631

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

650

</tr>

651

<tr>

652

653

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

653

654

</td>

655

</tr>

656

<tr>

664

<hr>

665

666

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

667

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

668

<code>const gchar *key</code>,

667

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>GError **err</code>);</pre>

670

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

671

672

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

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

700

</tr>

701

<tr>

702

703

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

703

704

</td>

705

</tr>

706

<tr>

715

<hr>

716

717

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

718

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

719

<code>const gchar *key</code>,

720

<code>GError **err</code>);</pre>

718

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

720

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

721

722

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

723

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

738

</tr>

739

<tr>

740

741

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

741

742

</td>

743

</tr>

744

<tr>

753

<hr>

754

755

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

756

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

757

<code>const gchar *key</code>,

758

<code>const gchar *schema_key</code>,

759

<code>GError **err</code>);</pre>

756

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

758

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *schema_key</code>,

759

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

760

761

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

762

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

785

</tr>

786

<tr>

787

788

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

788

789

</td>

790

</tr>

791

<tr>

800

<hr>

801

802

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

803

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

804

<code>const gchar *dir</code>,

805

<code>GError **err</code>);</pre>

803

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

805

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

806

807

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

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>

809

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

810

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

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>

812

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

812

each list element, then <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a> the list itself.

813

814

815

826

</tr>

827

<tr>

828

829

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

829

830

</td>

831

</tr>

832

<tr>

840

<hr>

841

842

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

843

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

844

<code>const gchar *dir</code>,

845

<code>GError **err</code>);</pre>

843

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

845

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

846

847

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

848

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="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> each string in the list, then <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a> the list itself.

849

850

851

862

</tr>

863

<tr>

864

865

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

865

866

</td>

867

</tr>

868

<tr>

877

878

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

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>GError **err</code>);</pre>

880

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

881

882

Suggests to gconfd that you've just finished

883

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

897

</tr>

898

<tr>

899

900

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

900

901

</td>

902

</tr>

903

</tbody>

906

<hr>

907

908

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

909

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

910

<code>const gchar *dir</code>,

911

<code>GError **err</code>);</pre>

909

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

911

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

912

913

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

914

database. Returns TRUE or FALSE.

928

</tr>

929

<tr>

930

931

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

931

932

</td>

933

</tr>

934

<tr>

944

945

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

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 gchar *dir</code>,

948

<code>GError **err</code>);</pre>

947

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

948

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

949

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

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

967

</tr>

968

<tr>

969

970

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

970

971

</td>

972

</tr>

973

</tbody>

976

<hr>

977

978

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

979

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

980

<code>const gchar *key</code>,

981

<code>GError **err</code>);</pre>

979

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

981

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

982

983

Checks whether the key is writable.

984

997

</tr>

998

<tr>

999

1000

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

1000

1001

</td>

1002

</tr>

1003

<tr>

1012

<hr>

1013

1014

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

1015

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

1016

<code>gchar **why_invalid</code>);</pre>

1015

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gconf_valid_key (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1016

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **why_invalid</code>);</pre>

1017

1018

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

1019

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

1035

</tr>

1036

<tr>

1037

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

1038

<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="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> the returned string.

1039

</td>

1040

</tr>

1041

<tr>

1050

<hr>

1051

1052

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

1053

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

1054

<code>const gchar *below</code>);</pre>

1053

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gconf_key_is_below (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *above</code>,

1054

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *below</code>);</pre>

1055

1056

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

1057

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

1084

<hr>

1085

1086

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

1087

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

1088

<code>const gchar *key</code>);</pre>

1087

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * gconf_concat_dir_and_key (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *dir</code>,

1088

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>);</pre>

1089

1090

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

1091

and returns the new string.

1114

<hr>

1115

1116

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

1117

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

1117

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * gconf_unique_key (<code>void</code>);</pre>

1118

1119

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

1120

random number generated.

1123

1124

1125

<td>Returns :</td>

1126

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

1126

<td>a newly created key, a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> value.

1127

</td>

1128

</tr></tbody>

1129

</table></div>

1131

<hr>

1132

1133

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

1134

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

1134

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

1135

1136

1137

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

1164

<hr>

1165

1166

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

1167

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

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

1194

<hr>

1195

1196

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

1197

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

1198

<code>const gchar *key</code>,

1199

<code>GError **err</code>);</pre>

1197

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1199

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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

1202

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

1218

</tr>

1219

<tr>

1220

1221

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

1221

1222

</td>

1223

</tr>

1224

<tr>

1232

<hr>

1233

1234

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

1235

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

1236

<code>const gchar *key</code>,

1237

<code>GError **err</code>);</pre>

1235

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1237

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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

1240

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

1256

</tr>

1257

<tr>

1258

1259

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

1259

1260

</td>

1261

</tr>

1262

<tr>

1270

<hr>

1271

1272

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

1273

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

1274

<code>const gchar *key</code>,

1275

<code>GError **err</code>);</pre>

1273

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1275

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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

1278

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

1294

</tr>

1295

<tr>

1296

1297

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

1297

1298

</td>

1299

</tr>

1300

<tr>

1308

<hr>

1309

1310

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

1311

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

1312

<code>const gchar *key</code>,

1313

<code>GError **err</code>);</pre>

1311

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1313

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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

1316

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

1332

</tr>

1333

<tr>

1334

1335

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

1335

1336

</td>

1337

</tr>

1338

<tr>

1346

<hr>

1347

1348

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

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 gchar *key</code>,

1351

<code>GError **err</code>);</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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1351

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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>.

1354

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

1370

</tr>

1371

<tr>

1372

1373

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

1373

1374

</td>

1375

</tr>

1376

<tr>

1384

<hr>

1385

1386

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

1387

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

1388

<code>const gchar *key</code>,

1387

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>GError **err</code>);</pre>

1390

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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

1393

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

1418

<tbody>

1419

<tr>

1420

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

1421

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

1421

<td>The integer itself, converted with <a href="http://library.gnome.org/devel/glib/unstable/glib-Type-Conversion-Macros.html#GINT-TO-POINTER:CAPS"><code class="function">GINT_TO_POINTER()</code></a>

1422

</td>

1423

</tr>

1424

<tr>

1425

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

1426

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

1426

<td>The bool itself, converted with <a href="http://library.gnome.org/devel/glib/unstable/glib-Type-Conversion-Macros.html#GINT-TO-POINTER:CAPS"><code class="function">GINT_TO_POINTER()</code></a>

1427

</td>

1428

</tr>

1429

<tr>

1430

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

1431

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

1431

<td>A pointer to <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble">gdouble</a>, which should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

1432

</td>

1433

</tr>

1434

<tr>

1435

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

1436

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

1436

<td>A pointer to <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>, which should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

1437

</td>

1438

</tr>

1439

<tr>

1445

</table></div>

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

1448

<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="http://library.gnome.org/devel/glib/unstable/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

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

1450

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

1450

list itself with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>.

1451

1452

1453

1469

</tr>

1470

<tr>

1471

1472

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

1472

1473

</td>

1474

</tr>

1475

<tr>

1483

<hr>

1484

1485

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

1486

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

1487

<code>const gchar *key</code>,

1486

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>gpointer car_retloc</code>,

1491

<code>gpointer cdr_retloc</code>,

1492

<code>GError **err</code>);</pre>

1490

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> car_retloc</code>,

1491

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> cdr_retloc</code>,

1492

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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

1495

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

1516

<tbody>

1517

<tr>

1518

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

1519

<td>pointer to gint

1519

<td>pointer to <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a>

1520

</td>

1521

</tr>

1522

<tr>

1523

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

1524

<td>pointer to gboolean

1524

<td>pointer to <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

1525

</td>

1526

</tr>

1527

<tr>

1528

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

1529

<td>pointer to gdouble

1529

<td>pointer to <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble">gdouble</a>

1530

</td>

1531

</tr>

1532

<tr>

1533

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

1534

<td>pointer to gchar*</td>

1534

<td>pointer to <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>*</td>

1535

</tr>

1536

<tr>

1537

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

1540

</tbody>

1541

</table></div>

1542

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 <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="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> the string(s)

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

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

1546

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

1613

</tr>

1614

<tr>

1615

1616

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

1616

1617

</td>

1618

</tr>

1619

<tr>

1628

<hr>

1629

1630

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

1631

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

1632

<code>const gchar *key</code>,

1633

<code>gdouble val</code>,

1634

<code>GError **err</code>);</pre>

1631

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1633

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble">gdouble</a> val</code>,

1634

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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.

1637

1655

</tr>

1656

<tr>

1657

1658

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

1658

1659

</td>

1660

</tr>

1661

<tr>

1670

<hr>

1671

1672

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

1673

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

1674

<code>const gchar *key</code>,

1675

<code>gint val</code>,

1676

<code>GError **err</code>);</pre>

1673

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1675

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> val</code>,

1676

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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.

1679

1697

</tr>

1698

<tr>

1699

1700

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

1700

1701

</td>

1702

</tr>

1703

<tr>

1712

<hr>

1713

1714

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

1715

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

1716

<code>const gchar *key</code>,

1717

<code>const gchar *val</code>,

1718

<code>GError **err</code>);</pre>

1715

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1717

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *val</code>,

1718

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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.

1721

1739

</tr>

1740

<tr>

1741

1742

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

1742

1743

</td>

1744

</tr>

1745

<tr>

1754

<hr>

1755

1756

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

1757

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

1758

<code>const gchar *key</code>,

1759

<code>gboolean val</code>,

1760

<code>GError **err</code>);</pre>

1757

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

1759

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> val</code>,

1760

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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.

1763

1781

</tr>

1782

<tr>

1783

1784

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

1784

1785

</td>

1786

</tr>

1787

<tr>

1796

<hr>

1797

1798

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

1799

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

1800

<code>const gchar *key</code>,

1799

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>GError **err</code>);</pre>

1802

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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.

1805

1823

</tr>

1824

<tr>

1825

1826

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

1826

1827

</td>

1828

</tr>

1829

<tr>

1838

<hr>

1839

1840

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

1841

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

1842

<code>const gchar *key</code>,

1841

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>GSList *list</code>,

1845

<code>GError **err</code>);</pre>

1844

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList">GSList</a> *list</code>,

1845

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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

1848

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

1873

</tr>

1874

<tr>

1875

1876

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

1876

1877

</td>

1878

</tr>

1879

<tr>

1888

<hr>

1889

1890

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

1891

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

1892

<code>const gchar *key</code>,

1891

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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>gconstpointer address_of_car</code>,

1896

<code>gconstpointer address_of_cdr</code>,

1897

<code>GError **err</code>);</pre>

1895

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer">gconstpointer</a> address_of_car</code>,

1896

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer">gconstpointer</a> address_of_cdr</code>,

1897

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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

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

1935

</tr>

1936

<tr>

1937

1938

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

1938

1939

</td>

1940

</tr>

1941

<tr>

1961

<hr>

1962

1963

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

1964

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

1965

<code>const gchar *str</code>,

1966

<code>gint *enum_value_retloc</code>);</pre>

1964

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *str</code>,

1966

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *enum_value_retloc</code>);</pre>

1967

1968

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

1969

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

2019

<hr>

2020

2021

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

2022

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

2023

<code>gint enum_value</code>);</pre>

2022

<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> enum_value</code>);</pre>

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.

2026

2049

2050

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

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>GError **err</code>);</pre>

2052

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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

2055

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

2065

</tr>

2066

<tr>

2067

2068

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

2068

2069

</td>

2070

</tr>

2071

</tbody>

2075

2076

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

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>GError **err</code>);</pre>

2078

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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

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

2091

</tr>

2092

<tr>

2093

2094

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

2094

2095

</td>

2096

</tr>

2097

</tbody>

2101

2102

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

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 gchar *key</code>,

2105

<code>const gchar *locale</code>,

2106

<code>gboolean use_schema_default</code>,

2107

<code>gboolean *is_default_p</code>,

2108

<code>gboolean *is_writable_p</code>,

2109

<code>GError **err</code>);</pre>

2104

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *key</code>,

2105

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *locale</code>,

2106

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> use_schema_default</code>,

2107

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> *is_default_p</code>,

2108

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> *is_writable_p</code>,

2109

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **err</code>);</pre>

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.

2112

2131

</tr>

2132

<tr>

2133

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

2134

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

2134

<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> value, indicating whether schema information is to be used as the default

2135

value.

2136

</td>

2137

</tr>

2138

<tr>

2139

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

2140

<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="http://library.gnome.org/devel/glib/unstable/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

2141

otherwise.

2142

</td>

2143

</tr>

2144

<tr>

2145

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

2146

<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="http://library.gnome.org/devel/glib/unstable/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

2147

otherwise.

2148

</td>

2149

</tr>

2150

<tr>

2151

2152

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

2152

2153

</td>

2154

</tr>

2155

<tr>

Older »