|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/gconf/ |
Upload File : |
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GConfValue, GConfEntry, GConfMetaInfo</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<link rel="start" href="index.html" title="GConf Reference Manual">
<link rel="up" href="ch01.html" title="Using the GConf library">
<link rel="prev" href="gconf-gconf-sources.html" title="gconf-sources">
<link rel="next" href="gconf-gconf.html" title="GConf Core Interfaces">
<meta name="generator" content="GTK-Doc V1.4 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="ch01.html" title="Using the GConf library">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="gconf-gconf-sources.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GConf Reference Manual</th>
<td><a accesskey="n" href="gconf-gconf.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry" lang="en">
<a name="gconf-gconf-value"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle">GConfValue, GConfEntry, GConfMetaInfo</span></h2>
<p>GConfValue, GConfEntry, GConfMetaInfo —
A <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> stores a dynamically-typed value. A <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> stores a
key-value pair. A <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a> stores metainformation about a key.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
enum <a href="gconf-gconf-value.html#GConfValueType">GConfValueType</a>;
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a>;
#define <a href="gconf-gconf-value.html#GCONF-VALUE-TYPE-VALID:CAPS">GCONF_VALUE_TYPE_VALID</a> (x)
const char* <a href="gconf-gconf-value.html#gconf-value-get-string">gconf_value_get_string</a> (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);
int <a href="gconf-gconf-value.html#gconf-value-get-int">gconf_value_get_int</a> (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);
double <a href="gconf-gconf-value.html#gconf-value-get-float">gconf_value_get_float</a> (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);
<a href="gconf-gconf-value.html#GConfValueType">GConfValueType</a> <a href="gconf-gconf-value.html#gconf-value-get-list-type">gconf_value_get_list_type</a> (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);
GSList* <a href="gconf-gconf-value.html#gconf-value-get-list">gconf_value_get_list</a> (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* <a href="gconf-gconf-value.html#gconf-value-get-car">gconf_value_get_car</a> (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* <a href="gconf-gconf-value.html#gconf-value-get-cdr">gconf_value_get_cdr</a> (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);
gboolean <a href="gconf-gconf-value.html#gconf-value-get-bool">gconf_value_get_bool</a> (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);
<a href="gconf-gconf-schema.html#GConfSchema">GConfSchema</a>* <a href="gconf-gconf-value.html#gconf-value-get-schema">gconf_value_get_schema</a> (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* <a href="gconf-gconf-value.html#gconf-value-new">gconf_value_new</a> (<a href="gconf-gconf-value.html#GConfValueType">GConfValueType</a> type);
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* <a href="gconf-gconf-value.html#gconf-value-new-from-string">gconf_value_new_from_string</a> (<a href="gconf-gconf-value.html#GConfValueType">GConfValueType</a> type,
const gchar *str,
GError **err);
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* <a href="gconf-gconf-value.html#gconf-value-copy">gconf_value_copy</a> (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *src);
void <a href="gconf-gconf-value.html#gconf-value-free">gconf_value_free</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);
void <a href="gconf-gconf-value.html#gconf-value-set-int">gconf_value_set_int</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
gint the_int);
void <a href="gconf-gconf-value.html#gconf-value-set-string">gconf_value_set_string</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
const gchar *the_str);
void <a href="gconf-gconf-value.html#gconf-value-set-float">gconf_value_set_float</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
gdouble the_float);
void <a href="gconf-gconf-value.html#gconf-value-set-bool">gconf_value_set_bool</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
gboolean the_bool);
void <a href="gconf-gconf-value.html#gconf-value-set-schema">gconf_value_set_schema</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
const <a href="gconf-gconf-schema.html#GConfSchema">GConfSchema</a> *sc);
void <a href="gconf-gconf-value.html#gconf-value-set-schema-nocopy">gconf_value_set_schema_nocopy</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
<a href="gconf-gconf-schema.html#GConfSchema">GConfSchema</a> *sc);
void <a href="gconf-gconf-value.html#gconf-value-set-car">gconf_value_set_car</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *car);
void <a href="gconf-gconf-value.html#gconf-value-set-car-nocopy">gconf_value_set_car_nocopy</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *car);
void <a href="gconf-gconf-value.html#gconf-value-set-cdr">gconf_value_set_cdr</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *cdr);
void <a href="gconf-gconf-value.html#gconf-value-set-cdr-nocopy">gconf_value_set_cdr_nocopy</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *cdr);
void <a href="gconf-gconf-value.html#gconf-value-set-list-type">gconf_value_set_list_type</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
<a href="gconf-gconf-value.html#GConfValueType">GConfValueType</a> type);
void <a href="gconf-gconf-value.html#gconf-value-set-list-nocopy">gconf_value_set_list_nocopy</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
GSList *list);
void <a href="gconf-gconf-value.html#gconf-value-set-list">gconf_value_set_list</a> (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
GSList *list);
gchar* <a href="gconf-gconf-value.html#gconf-value-to-string">gconf_value_to_string</a> (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);
<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a>;
<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a>* <a href="gconf-gconf-value.html#gconf-meta-info-new">gconf_meta_info_new</a> (void);
void <a href="gconf-gconf-value.html#gconf-meta-info-free">gconf_meta_info_free</a> (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi);
const char* <a href="gconf-gconf-value.html#gconf-meta-info-get-schema">gconf_meta_info_get_schema</a> (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi);
const char* <a href="gconf-gconf-value.html#gconf-meta-info-get-mod-user">gconf_meta_info_get_mod_user</a> (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi);
GTime <a href="gconf-gconf-value.html#gconf-meta-info-mod-time">gconf_meta_info_mod_time</a> (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi);
void <a href="gconf-gconf-value.html#gconf-meta-info-set-schema">gconf_meta_info_set_schema</a> (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi,
const gchar *schema_name);
void <a href="gconf-gconf-value.html#gconf-meta-info-set-mod-user">gconf_meta_info_set_mod_user</a> (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi,
const gchar *mod_user);
void <a href="gconf-gconf-value.html#gconf-meta-info-set-mod-time">gconf_meta_info_set_mod_time</a> (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi,
GTime mod_time);
<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a>;
const char* <a href="gconf-gconf-value.html#gconf-entry-get-key">gconf_entry_get_key</a> (const <a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* <a href="gconf-gconf-value.html#gconf-entry-get-value">gconf_entry_get_value</a> (const <a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);
const char* <a href="gconf-gconf-value.html#gconf-entry-get-schema-name">gconf_entry_get_schema_name</a> (const <a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);
gboolean <a href="gconf-gconf-value.html#gconf-entry-get-is-default">gconf_entry_get_is_default</a> (const <a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);
gboolean <a href="gconf-gconf-value.html#gconf-entry-get-is-writable">gconf_entry_get_is_writable</a> (const <a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);
<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a>* <a href="gconf-gconf-value.html#gconf-entry-new">gconf_entry_new</a> (const gchar *key,
const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *val);
<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a>* <a href="gconf-gconf-value.html#gconf-entry-new-nocopy">gconf_entry_new_nocopy</a> (gchar *key,
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *val);
<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a>* <a href="gconf-gconf-value.html#gconf-entry-copy">gconf_entry_copy</a> (const <a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *src);
void <a href="gconf-gconf-value.html#gconf-entry-free">gconf_entry_free</a> (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);
void <a href="gconf-gconf-value.html#gconf-entry-ref">gconf_entry_ref</a> (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);
void <a href="gconf-gconf-value.html#gconf-entry-unref">gconf_entry_unref</a> (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* <a href="gconf-gconf-value.html#gconf-entry-steal-value">gconf_entry_steal_value</a> (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);
void <a href="gconf-gconf-value.html#gconf-entry-set-value">gconf_entry_set_value</a> (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry,
const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *val);
void <a href="gconf-gconf-value.html#gconf-entry-set-value-nocopy">gconf_entry_set_value_nocopy</a> (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry,
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *val);
void <a href="gconf-gconf-value.html#gconf-entry-set-schema-name">gconf_entry_set_schema_name</a> (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry,
const gchar *name);
void <a href="gconf-gconf-value.html#gconf-entry-set-is-default">gconf_entry_set_is_default</a> (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry,
gboolean is_default);
void <a href="gconf-gconf-value.html#gconf-entry-set-is-writable">gconf_entry_set_is_writable</a> (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry,
gboolean is_writable);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2588888"></a><h2>Description</h2>
<p>
<a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> stores one of the value types GConf understands; GConf
uses <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> to pass values around because it doesn't know the
type of its values at compile time.
</p>
<p>
A <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> pairs a relative key
name with a value, for example if the value "10" is stored at the key
"/foo/bar/baz", the <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> will store "baz" and "10".
</p>
<p>
A <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a> object holds metainformation about a key, such as
its last modification time and the name of the schema associated with
it. You should rarely if ever need to use <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a>.
(In fact you can't get the metainfo for a key using the current API.)
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2588958"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2588964"></a><h3>
<a name="GConfValueType"></a>enum GConfValueType</h3>
<a class="indexterm" name="id2588974"></a><pre class="programlisting">typedef enum {
GCONF_VALUE_INVALID,
GCONF_VALUE_STRING,
GCONF_VALUE_INT,
GCONF_VALUE_FLOAT,
GCONF_VALUE_BOOL,
GCONF_VALUE_SCHEMA,
/* unfortunately these aren't really types; we want list_of_string,
list_of_int, etc. but it's just too complicated to implement.
instead we'll complain in various places if you do something
moronic like mix types in a list or treat pair<string,int> and
pair<float,bool> as the same type. */
GCONF_VALUE_LIST,
GCONF_VALUE_PAIR
} GConfValueType;
</pre>
<p>
Used to indicate the type of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><code class="literal">GCONF_VALUE_INVALID</code></span></td>
<td>Never the type of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> obtained from GConf functions; used to indicate errors and the like.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">GCONF_VALUE_STRING</code></span></td>
<td>String value (<span class="type">gchar</span>*).
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">GCONF_VALUE_INT</code></span></td>
<td>Integer value (<span class="type">gint</span>).
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">GCONF_VALUE_FLOAT</code></span></td>
<td>Floating point value (<span class="type">gdouble</span>).
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">GCONF_VALUE_BOOL</code></span></td>
<td>Boolean value (<span class="type">gboolean</span>).
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">GCONF_VALUE_SCHEMA</code></span></td>
<td>Schema value (<a href="gconf-gconf-schema.html#GConfSchema"><span class="type">GConfSchema</span></a>).
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">GCONF_VALUE_LIST</code></span></td>
<td>List of <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>; <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> elements must have
a primitive type (i.e. they may not be lists or pairs), and all elements
of a list must have the same type.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">GCONF_VALUE_PAIR</code></span></td>
<td>Pair of <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>; the first field (car) and the second
field (cdr) may have different types. The two elements of a pair must be primitive
types, not lists or pairs.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2589167"></a><h3>
<a name="GConfValue"></a>GConfValue</h3>
<a class="indexterm" name="id2589175"></a><pre class="programlisting">typedef struct {
GConfValueType type;
} GConfValue;
</pre>
<p>
Represents a dynamically-typed value. The <em class="parameter"><code>type</code></em> field tells you the
type of the value; the other fields should be accessed with the
accessor functions and macros.
</p>
<p>
<span class="emphasis"><em>A <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> should always
be initialized before use. That is, you should not use a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>
unless you have called one of the functions beginning with
"gconf_value_set_".</em></span>. For lists, initialization has two
steps: first you must set the list element type, then you must set the
list value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><a href="gconf-gconf-value.html#GConfValueType">GConfValueType</a> <em class="structfield"><code>type</code></em>;</span></td>
<td>The <a href="gconf-gconf-value.html#GConfValueType"><span class="type">GConfValueType</span></a> of this <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>. The only field of
<a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> you should access directly.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2589263"></a><h3>
<a name="GCONF-VALUE-TYPE-VALID:CAPS"></a>GCONF_VALUE_TYPE_VALID()</h3>
<a class="indexterm" name="id2589272"></a><pre class="programlisting">#define GCONF_VALUE_TYPE_VALID(x) (((x) > GCONF_VALUE_INVALID) && ((x) <= GCONF_VALUE_PAIR))
</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2589304"></a><h3>
<a name="gconf-value-get-string"></a>gconf_value_get_string ()</h3>
<a class="indexterm" name="id2589312"></a><pre class="programlisting">const char* gconf_value_get_string (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);</pre>
<p>
Returns a <span class="symbol">const gchar*</span> for a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_STRING</code>. The returned string is <span class="emphasis"><em>not</em></span> a
copy, don't try to free it. It is "owned" by the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> and will
be destroyed when the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> is destroyed.
</p>
<p>
If the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> is not initialized (i.e. no one has called
<a href="gconf-gconf-value.html#gconf-value-set-string"><code class="function">gconf_value_set_string()</code></a>) then the string may be
<span class="symbol">NULL</span>, but of course you should not try to use an
uninitialized <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a const char*.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2589431"></a><h3>
<a name="gconf-value-get-int"></a>gconf_value_get_int ()</h3>
<a class="indexterm" name="id2589440"></a><pre class="programlisting">int gconf_value_get_int (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);</pre>
<p>
Returns a <span class="type">gint</span> for a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_INT</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <span class="type">gint</span>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2589520"></a><h3>
<a name="gconf-value-get-float"></a>gconf_value_get_float ()</h3>
<a class="indexterm" name="id2589528"></a><pre class="programlisting">double gconf_value_get_float (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);</pre>
<p>
Returns a <span class="type">gdouble</span> for a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_FLOAT</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <span class="type">gdouble</span>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2589609"></a><h3>
<a name="gconf-value-get-list-type"></a>gconf_value_get_list_type ()</h3>
<a class="indexterm" name="id2589618"></a><pre class="programlisting"><a href="gconf-gconf-value.html#GConfValueType">GConfValueType</a> gconf_value_get_list_type (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);</pre>
<p>
Returns the type of the list elements in a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_LIST</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the type of the list elements (a primitive type).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2589688"></a><h3>
<a name="gconf-value-get-list"></a>gconf_value_get_list ()</h3>
<a class="indexterm" name="id2589696"></a><pre class="programlisting">GSList* gconf_value_get_list (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);</pre>
<p>
Returns a <span class="type">GSList</span> containing <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> objects. Each <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> in
the returned list will have the type returned by
<a href="gconf-gconf-value.html#gconf-value-get-list-type"><code class="function">gconf_value_get_list_type()</code></a>. Remember that the empty <span class="type">GSList</span> is equal to
<span class="symbol">NULL</span>. The list is not a copy; it is "owned" by the
<a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> and will be destroyed when the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> is destroyed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <span class="type">GList</span>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2589811"></a><h3>
<a name="gconf-value-get-car"></a>gconf_value_get_car ()</h3>
<a class="indexterm" name="id2589819"></a><pre class="programlisting"><a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* gconf_value_get_car (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);</pre>
<p>
Returns the first member (car) of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_PAIR</code>. The car is another <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>, with a primitive
type (bool, int, float, string, schema).
</p>
<p>
The returned value is not a copy; it is "owned" by the pair and will
be destroyed when the pair is destroyed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the first member of a pair, a primitive type.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2589902"></a><h3>
<a name="gconf-value-get-cdr"></a>gconf_value_get_cdr ()</h3>
<a class="indexterm" name="id2589910"></a><pre class="programlisting"><a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* gconf_value_get_cdr (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);</pre>
<p>
Returns the second member (cdr) of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_PAIR</code>. The cdr is another <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>, with a primitive
type (bool, int, float, string, schema).
</p>
<p>
The returned value is not a copy; it is "owned" by the pair and will
be destroyed when the pair is destroyed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the second member of a pair, a primitive type.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2589992"></a><h3>
<a name="gconf-value-get-bool"></a>gconf_value_get_bool ()</h3>
<a class="indexterm" name="id2590001"></a><pre class="programlisting">gboolean gconf_value_get_bool (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);</pre>
<p>
Returns a <span class="type">gboolean</span> for a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_BOOL</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <span class="type">gboolean</span> value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2590081"></a><h3>
<a name="gconf-value-get-schema"></a>gconf_value_get_schema ()</h3>
<a class="indexterm" name="id2590089"></a><pre class="programlisting"><a href="gconf-gconf-schema.html#GConfSchema">GConfSchema</a>* gconf_value_get_schema (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);</pre>
<p>
Returns a <a href="gconf-gconf-schema.html#GConfSchema"><span class="type">GConfSchema</span></a> for a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_SCHEMA</code>. If the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> is uninitialized, it
may return <span class="symbol">NULL</span>; but of course you should have
initialized the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>. The GConf library will not return values
with a <span class="symbol">NULL</span> schema.
</p>
<p>
The returned value is not a copy; it is "owned" by the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> and will
be destroyed when the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> is destroyed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <a href="gconf-gconf-schema.html#GConfSchema"><span class="type">GConfSchema</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2590209"></a><h3>
<a name="gconf-value-new"></a>gconf_value_new ()</h3>
<a class="indexterm" name="id2590217"></a><pre class="programlisting"><a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* gconf_value_new (<a href="gconf-gconf-value.html#GConfValueType">GConfValueType</a> type);</pre>
<p>
Creates a new <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <em class="parameter"><code>type</code></em>. The type is immutable after
creation; values have a fixed type. You <span class="emphasis"><em>must</em></span>
initialize the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> after creation; that is, you must set its
value with one of the "setter" functions.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>type</code></em> :</span></td>
<td>type of the new <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>newly-allocated <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2590304"></a><h3>
<a name="gconf-value-new-from-string"></a>gconf_value_new_from_string ()</h3>
<a class="indexterm" name="id2590313"></a><pre class="programlisting"><a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* gconf_value_new_from_string (<a href="gconf-gconf-value.html#GConfValueType">GConfValueType</a> type,
const gchar *str,
GError **err);</pre>
<p>
Creates a new <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <em class="parameter"><code>type</code></em> and value set to the string passed.
Based on the value of <em class="parameter"><code>type</code></em>, this function does the appropriate conversion of the
string passed to the <em class="parameter"><code>type</code></em>, does error checks to ensure the value is valid, and
then calls the appropriate gconf_set function depending on the <em class="parameter"><code>type</code></em> to set the value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>type</code></em> :</span></td>
<td>type of the new <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>str</code></em> :</span></td>
<td>the return location for an allocated <span class="type">GError</span>, or <span class="symbol">NULL</span> to ignore errors.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>err</code></em> :</span></td>
<td>the value to be set.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the value to be set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2590449"></a><h3>
<a name="gconf-value-copy"></a>gconf_value_copy ()</h3>
<a class="indexterm" name="id2590457"></a><pre class="programlisting"><a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* gconf_value_copy (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *src);</pre>
<p>
Copies a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>. The copy is a deep copy, that is, any allocated
memory inside the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> will also be copied.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>src</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> to copy.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a newly-allocated <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> identical to <em class="parameter"><code>src</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2590539"></a><h3>
<a name="gconf-value-free"></a>gconf_value_free ()</h3>
<a class="indexterm" name="id2590547"></a><pre class="programlisting">void gconf_value_free (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);</pre>
<p>
Deallocates a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>. Also deallocates any allocated memory
inside the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> (such as lists, pair members, strings, and schemas).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> to destroy.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2590609"></a><h3>
<a name="gconf-value-set-int"></a>gconf_value_set_int ()</h3>
<a class="indexterm" name="id2590617"></a><pre class="programlisting">void gconf_value_set_int (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
gint the_int);</pre>
<p>
Sets the value of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_INT</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> of type <code class="literal">GCONF_VALUE_INT</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>the_int</code></em> :</span></td>
<td>the integer.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2590699"></a><h3>
<a name="gconf-value-set-string"></a>gconf_value_set_string ()</h3>
<a class="indexterm" name="id2590708"></a><pre class="programlisting">void gconf_value_set_string (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
const gchar *the_str);</pre>
<p>
Sets the value of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_STRING</code>. <em class="parameter"><code>the_str</code></em> is copied.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> of type <code class="literal">GCONF_VALUE_STRING</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>the_str</code></em> :</span></td>
<td>the string.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2590796"></a><h3>
<a name="gconf-value-set-float"></a>gconf_value_set_float ()</h3>
<a class="indexterm" name="id2590804"></a><pre class="programlisting">void gconf_value_set_float (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
gdouble the_float);</pre>
<p>
Sets the value of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_FLOAT</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> of type <code class="literal">GCONF_VALUE_FLOAT</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>the_float</code></em> :</span></td>
<td>the floating point number.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2590887"></a><h3>
<a name="gconf-value-set-bool"></a>gconf_value_set_bool ()</h3>
<a class="indexterm" name="id2590895"></a><pre class="programlisting">void gconf_value_set_bool (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
gboolean the_bool);</pre>
<p>
Sets the value of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_BOOL</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> of type <code class="literal">GCONF_VALUE_BOOL</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>the_bool</code></em> :</span></td>
<td>a boolean value (<span class="symbol">TRUE</span> or <span class="symbol">FALSE</span>).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2590984"></a><h3>
<a name="gconf-value-set-schema"></a>gconf_value_set_schema ()</h3>
<a class="indexterm" name="id2590993"></a><pre class="programlisting">void gconf_value_set_schema (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
const <a href="gconf-gconf-schema.html#GConfSchema">GConfSchema</a> *sc);</pre>
<p>
Sets the value of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_SCHEMA</code>. The
<a href="gconf-gconf-schema.html#GConfSchema"><span class="type">GConfSchema</span></a> is copied. Alternatively you can use
<a href="gconf-gconf-value.html#gconf-value-set-schema-nocopy"><code class="function">gconf_value_set_schema_nocopy()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_SCHEMA</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>sc</code></em> :</span></td>
<td>the <a href="gconf-gconf-schema.html#GConfSchema"><span class="type">GConfSchema</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2591098"></a><h3>
<a name="gconf-value-set-schema-nocopy"></a>gconf_value_set_schema_nocopy ()</h3>
<a class="indexterm" name="id2591108"></a><pre class="programlisting">void gconf_value_set_schema_nocopy (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
<a href="gconf-gconf-schema.html#GConfSchema">GConfSchema</a> *sc);</pre>
<p>
Sets the value of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_SCHEMA</code>. The <a href="gconf-gconf-schema.html#GConfSchema"><span class="type">GConfSchema</span></a> is <span class="emphasis"><em>not</em></span>
copied; the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> takes ownership of it, and it should only be
accessed via the <a href="gconf-gconf-value.html#gconf-value-get-schema"><code class="function">gconf_value_get_schema()</code></a> macro. This function is provided
as a more efficient version of <a href="gconf-gconf-value.html#gconf-value-set-schema"><code class="function">gconf_value_set_schema()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_SCHEMA</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>sc</code></em> :</span></td>
<td>the <a href="gconf-gconf-schema.html#GConfSchema"><span class="type">GConfSchema</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2591232"></a><h3>
<a name="gconf-value-set-car"></a>gconf_value_set_car ()</h3>
<a class="indexterm" name="id2591241"></a><pre class="programlisting">void gconf_value_set_car (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *car);</pre>
<p>
Sets the value of the first field (car) of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_PAIR</code>. The <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> is copied. Alternatively, use
<a href="gconf-gconf-value.html#gconf-value-set-car-nocopy"><code class="function">gconf_value_set_car_nocopy()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_PAIR</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>car</code></em> :</span></td>
<td>the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> to set as the car of the pair.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2591359"></a><h3>
<a name="gconf-value-set-car-nocopy"></a>gconf_value_set_car_nocopy ()</h3>
<a class="indexterm" name="id2591371"></a><pre class="programlisting">void gconf_value_set_car_nocopy (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *car);</pre>
<p>
Sets the value of the first field (car) of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_PAIR</code>. The <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> is <span class="emphasis"><em>not</em></span> copied;
the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> takes ownership of it. Alternatively, use
<a href="gconf-gconf-value.html#gconf-value-set-car"><code class="function">gconf_value_set_car()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_PAIR</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>car</code></em> :</span></td>
<td>the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> to set as the car of the pair.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2591500"></a><h3>
<a name="gconf-value-set-cdr"></a>gconf_value_set_cdr ()</h3>
<a class="indexterm" name="id2591511"></a><pre class="programlisting">void gconf_value_set_cdr (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *cdr);</pre>
<p>
Sets the value of the second field (cdr) of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_PAIR</code>. The <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> is copied. Alternatively, use
<a href="gconf-gconf-value.html#gconf-value-set-cdr-nocopy"><code class="function">gconf_value_set_cdr_nocopy()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_PAIR</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>cdr</code></em> :</span></td>
<td>the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> to set as the cdr of the pair.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2591630"></a><h3>
<a name="gconf-value-set-cdr-nocopy"></a>gconf_value_set_cdr_nocopy ()</h3>
<a class="indexterm" name="id2591642"></a><pre class="programlisting">void gconf_value_set_cdr_nocopy (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *cdr);</pre>
<p>
Sets the value of the second field (cdr) of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type
<code class="literal">GCONF_VALUE_PAIR</code>. The <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> is <span class="emphasis"><em>not</em></span> copied;
the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> takes ownership of it. Alternatively, use
<a href="gconf-gconf-value.html#gconf-value-set-cdr"><code class="function">gconf_value_set_cdr()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_PAIR</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>cdr</code></em> :</span></td>
<td>the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> to set as the cdr of the pair.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2591771"></a><h3>
<a name="gconf-value-set-list-type"></a>gconf_value_set_list_type ()</h3>
<a class="indexterm" name="id2591783"></a><pre class="programlisting">void gconf_value_set_list_type (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
<a href="gconf-gconf-value.html#GConfValueType">GConfValueType</a> type);</pre>
<p>
Sets the type of the elements in a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> of type
<code class="literal">GCONF_VALUE_LIST</code>. All the elements in the list must have the same
type. You must set the list type before you can set the list value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_LIST</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>type</code></em> :</span></td>
<td>the type of elements in this list.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2591879"></a><h3>
<a name="gconf-value-set-list-nocopy"></a>gconf_value_set_list_nocopy ()</h3>
<a class="indexterm" name="id2591891"></a><pre class="programlisting">void gconf_value_set_list_nocopy (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
GSList *list);</pre>
<p>
Sets the value of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_LIST</code>. The
<em class="parameter"><code>list</code></em> argument should be a <span class="type">GSList</span> of <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>. Each <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> in
the list must have the same type, and this type must be specified in
advance with <a href="gconf-gconf-value.html#gconf-value-set-list-type"><code class="function">gconf_value_set_list_type()</code></a>. This function does
<span class="emphasis"><em>not</em></span> copy the list; the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> will take
ownership of the list and its contents, and they will be destroyed
when the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> is destroyed. Alternatively, use
<a href="gconf-gconf-value.html#gconf-value-set-list"><code class="function">gconf_value_set_list()</code></a> to make a copy.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_LIST</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>list</code></em> :</span></td>
<td>the <span class="type">GSList</span> of <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> to set as the list value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2592068"></a><h3>
<a name="gconf-value-set-list"></a>gconf_value_set_list ()</h3>
<a class="indexterm" name="id2592079"></a><pre class="programlisting">void gconf_value_set_list (<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value,
GSList *list);</pre>
<p>
Sets the value of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_LIST</code>. The
<em class="parameter"><code>list</code></em> argument should be a <span class="type">GSList</span> of <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>. Each <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> in
the list must have the same type, and this type must be specified in
advance with <a href="gconf-gconf-value.html#gconf-value-set-list-type"><code class="function">gconf_value_set_list_type()</code></a>. This function copies the
list; it will not modify the <em class="parameter"><code>list</code></em> argument.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> with type <code class="literal">GCONF_VALUE_LIST</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>list</code></em> :</span></td>
<td>the <span class="type">GSList</span> of <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> to set as the list value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2592232"></a><h3>
<a name="gconf-value-to-string"></a>gconf_value_to_string ()</h3>
<a class="indexterm" name="id2592243"></a><pre class="programlisting">gchar* gconf_value_to_string (const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *value);</pre>
<p>
Creates a human-readable string representation of a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>. This
is intended for debugging and the like; the string representation is
not suitable for reliable machine parsing (that is, you shouldn't use
this function to save a value to a file or anything like that). The
exact nature of the string representation may change in future
versions. The returned string is newly-allocated and must be freed
with <code class="function">g_free()</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a newly-allocated string representing the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2592338"></a><h3>
<a name="GConfMetaInfo"></a>GConfMetaInfo</h3>
<a class="indexterm" name="id2592348"></a><pre class="programlisting">typedef struct {
gchar* schema;
gchar* mod_user; /* user owning the daemon that made the last modification */
GTime mod_time; /* time of the modification */
} GConfMetaInfo;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2592367"></a><h3>
<a name="gconf-meta-info-new"></a>gconf_meta_info_new ()</h3>
<a class="indexterm" name="id2592379"></a><pre class="programlisting"><a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a>* gconf_meta_info_new (void);</pre>
<p>
Creates a new <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a> structure and returns the newly allocated
<a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the newly allocated <span class="type">GConfMetainfo</span>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2592438"></a><h3>
<a name="gconf-meta-info-free"></a>gconf_meta_info_free ()</h3>
<a class="indexterm" name="id2592450"></a><pre class="programlisting">void gconf_meta_info_free (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi);</pre>
<p>
Frees the <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>gcmi</code></em> :</span></td>
<td>the <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a> to be freed.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2592511"></a><h3>
<a name="gconf-meta-info-get-schema"></a>gconf_meta_info_get_schema ()</h3>
<a class="indexterm" name="id2592523"></a><pre class="programlisting">const char* gconf_meta_info_get_schema (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi);</pre>
<p>
Returns the schema field of the <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gcmi</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the schema field, a char* value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2592596"></a><h3>
<a name="gconf-meta-info-get-mod-user"></a>gconf_meta_info_get_mod_user ()</h3>
<a class="indexterm" name="id2592608"></a><pre class="programlisting">const char* gconf_meta_info_get_mod_user (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi);</pre>
<p>
Returns the user owning the daemon that made the last modification of the key.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gcmi</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>mod_user, a char* value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2592675"></a><h3>
<a name="gconf-meta-info-mod-time"></a>gconf_meta_info_mod_time ()</h3>
<a class="indexterm" name="id2592687"></a><pre class="programlisting">GTime gconf_meta_info_mod_time (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi);</pre>
<p>
Returns the last modification time of the key.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gcmi</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the mod_time, a <span class="type">GTime</span> value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2592759"></a><h3>
<a name="gconf-meta-info-set-schema"></a>gconf_meta_info_set_schema ()</h3>
<a class="indexterm" name="id2592771"></a><pre class="programlisting">void gconf_meta_info_set_schema (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi,
const gchar *schema_name);</pre>
<p>
Sets the schema_name field of the <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a> to the name passed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gcmi</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>schema_name</code></em> :</span></td>
<td>the name to be set for the schema, a gchar* value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2592854"></a><h3>
<a name="gconf-meta-info-set-mod-user"></a>gconf_meta_info_set_mod_user ()</h3>
<a class="indexterm" name="id2592866"></a><pre class="programlisting">void gconf_meta_info_set_mod_user (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi,
const gchar *mod_user);</pre>
<p>
Sets the mod_user field of the <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a> to the user name passed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gcmi</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>mod_user</code></em> :</span></td>
<td>the value to be set, a char*.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2592950"></a><h3>
<a name="gconf-meta-info-set-mod-time"></a>gconf_meta_info_set_mod_time ()</h3>
<a class="indexterm" name="id2592961"></a><pre class="programlisting">void gconf_meta_info_set_mod_time (<a href="gconf-gconf-value.html#GConfMetaInfo">GConfMetaInfo</a> *gcmi,
GTime mod_time);</pre>
<p>
Sets the mod_last field of the <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a> to the mod_time passed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gcmi</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfMetaInfo"><span class="type">GConfMetaInfo</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>mod_time</code></em> :</span></td>
<td>a <span class="type">GTime</span>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2593051"></a><h3>
<a name="GConfEntry"></a>GConfEntry</h3>
<a class="indexterm" name="id2593062"></a><pre class="programlisting">typedef struct {
char *key;
GConfValue *value;
} GConfEntry;
</pre>
<p>
Stores an entry from a GConf "directory," including a key-value pair,
the name of the schema applicable to this entry, whether the value is
a default value, and whether GConf can write a new value at this
key. <em class="parameter"><code>key</code></em> should be an absolute key, not a relative key. (Note that
internally GConf breaks this rule sometimes; but in the public
interface, <em class="parameter"><code>key</code></em> is always an absolute key.) To access the key and
value, use <a href="gconf-gconf-value.html#gconf-entry-get-key"><code class="function">gconf_entry_get_key()</code></a> and <a href="gconf-gconf-value.html#gconf-entry-get-value"><code class="function">gconf_entry_get_value()</code></a>.
</p>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p>Value can be <span class="symbol">NULL</span>, indicating that the
value is not set.</p>
</div>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term">char *<em class="structfield"><code>key</code></em>;</span></td>
<td>an absolute key name.
</td>
</tr>
<tr>
<td>
<span class="term"><a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *<em class="structfield"><code>value</code></em>;</span></td>
<td>the value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2593172"></a><h3>
<a name="gconf-entry-get-key"></a>gconf_entry_get_key ()</h3>
<a class="indexterm" name="id2593184"></a><pre class="programlisting">const char* gconf_entry_get_key (const <a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);</pre>
<p>
Accesses the <em class="parameter"><code>key</code></em> field of a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>. The returned key is not a
copy, and should not be freed or modified.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the key , a char*.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2593263"></a><h3>
<a name="gconf-entry-get-value"></a>gconf_entry_get_value ()</h3>
<a class="indexterm" name="id2593274"></a><pre class="programlisting"><a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* gconf_entry_get_value (const <a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);</pre>
<p>
Accesses the <em class="parameter"><code>value</code></em> field of a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>. The returned value is not
a copy, and should not be freed or modified. If you have called
<a href="gconf-gconf-value.html#gconf-entry-steal-value"><code class="function">gconf_entry_steal_value()</code></a>, the returned value will be
<span class="symbol">NULL</span>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2593374"></a><h3>
<a name="gconf-entry-get-schema-name"></a>gconf_entry_get_schema_name ()</h3>
<a class="indexterm" name="id2593386"></a><pre class="programlisting">const char* gconf_entry_get_schema_name (const <a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);</pre>
<p>
Returns the schema_name field of the <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the schema_name , a char* value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2593458"></a><h3>
<a name="gconf-entry-get-is-default"></a>gconf_entry_get_is_default ()</h3>
<a class="indexterm" name="id2593470"></a><pre class="programlisting">gboolean gconf_entry_get_is_default (const <a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);</pre>
<p>
Returns the is_default field of the <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> , a gboolean value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <span class="type">gboolean</span> value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2593548"></a><h3>
<a name="gconf-entry-get-is-writable"></a>gconf_entry_get_is_writable ()</h3>
<a class="indexterm" name="id2593560"></a><pre class="programlisting">gboolean gconf_entry_get_is_writable (const <a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);</pre>
<p>
Returns the is_writable field of the <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>, a gboolean value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <span class="type">gboolean</span> value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2593638"></a><h3>
<a name="gconf-entry-new"></a>gconf_entry_new ()</h3>
<a class="indexterm" name="id2593649"></a><pre class="programlisting"><a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a>* gconf_entry_new (const gchar *key,
const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *val);</pre>
<p>
Creates a new <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> with key <em class="parameter"><code>key</code></em> and value <em class="parameter"><code>val</code></em> calling <a href="gconf-gconf-value.html#gconf-entry-new-nocopy"><code class="function">gconf_entry_new_nocopy()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>key</code></em> :</span></td>
<td>the key name.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>val</code></em> :</span></td>
<td>the value.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a new <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2593763"></a><h3>
<a name="gconf-entry-new-nocopy"></a>gconf_entry_new_nocopy ()</h3>
<a class="indexterm" name="id2593775"></a><pre class="programlisting"><a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a>* gconf_entry_new_nocopy (gchar *key,
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *val);</pre>
<p>
Creates a new <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> with key <em class="parameter"><code>key</code></em> and value <em class="parameter"><code>val</code></em>. <em class="parameter"><code>key</code></em> should be a full
path to the key, starting with '/'. Neither the key nor the value is copied;
both are freed when the <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> is freed. The string will be freed with
<code class="function">g_free()</code> so should be allocated with a GLib function, not <code class="function">malloc()</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>key</code></em> :</span></td>
<td>the key name.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>val</code></em> :</span></td>
<td>the value.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a new <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2593913"></a><h3>
<a name="gconf-entry-copy"></a>gconf_entry_copy ()</h3>
<a class="indexterm" name="id2593925"></a><pre class="programlisting"><a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a>* gconf_entry_copy (const <a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *src);</pre>
<p>
Copies the fields of an existing <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> and returns the new <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>src</code></em> :</span></td>
<td>the <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> to be copied.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the new <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2594010"></a><h3>
<a name="gconf-entry-free"></a>gconf_entry_free ()</h3>
<a class="indexterm" name="id2594021"></a><pre class="programlisting">void gconf_entry_free (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gconf_entry_free</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Destroys a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>, freeing the key, the value, and the entry itself.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> to free.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2594095"></a><h3>
<a name="gconf-entry-ref"></a>gconf_entry_ref ()</h3>
<a class="indexterm" name="id2594106"></a><pre class="programlisting">void gconf_entry_ref (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);</pre>
<p>
Increases the refcount of a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> by one.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2594166"></a><h3>
<a name="gconf-entry-unref"></a>gconf_entry_unref ()</h3>
<a class="indexterm" name="id2594178"></a><pre class="programlisting">void gconf_entry_unref (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);</pre>
<p>
Decreases the refcount of a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> by one and frees the
<a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> when the refcount becomes zero.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2594246"></a><h3>
<a name="gconf-entry-steal-value"></a>gconf_entry_steal_value ()</h3>
<a class="indexterm" name="id2594257"></a><pre class="programlisting"><a href="gconf-gconf-value.html#GConfValue">GConfValue</a>* gconf_entry_steal_value (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry);</pre>
<p>
Extracts the value from a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>, leaving the <em class="parameter"><code>value</code></em> field in
<a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> set to <span class="symbol">NULL</span>. Destroying the <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>
will <span class="emphasis"><em>not</em></span> destroy the value; the caller of
<a href="gconf-gconf-value.html#gconf-entry-steal-value"><code class="function">gconf_entry_steal_value()</code></a> assumes ownership of it.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> that the caller must free.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2594374"></a><h3>
<a name="gconf-entry-set-value"></a>gconf_entry_set_value ()</h3>
<a class="indexterm" name="id2594386"></a><pre class="programlisting">void gconf_entry_set_value (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry,
const <a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *val);</pre>
<p>
Sets the value field of the <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> to the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> passed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>val</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2594482"></a><h3>
<a name="gconf-entry-set-value-nocopy"></a>gconf_entry_set_value_nocopy ()</h3>
<a class="indexterm" name="id2594494"></a><pre class="programlisting">void gconf_entry_set_value_nocopy (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry,
<a href="gconf-gconf-value.html#GConfValue">GConfValue</a> *val);</pre>
<p>
Sets the value field to <em class="parameter"><code>val</code></em> after freeing the already existing value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>val</code></em> :</span></td>
<td>the <a href="gconf-gconf-value.html#GConfValue"><span class="type">GConfValue</span></a> to be set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2594582"></a><h3>
<a name="gconf-entry-set-schema-name"></a>gconf_entry_set_schema_name ()</h3>
<a class="indexterm" name="id2594594"></a><pre class="programlisting">void gconf_entry_set_schema_name (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry,
const gchar *name);</pre>
<p>
Sets the schema_name field of the <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> to the name passed after freeing
the already existing name.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td>the name to be set for the schema, a gchar* value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2594677"></a><h3>
<a name="gconf-entry-set-is-default"></a>gconf_entry_set_is_default ()</h3>
<a class="indexterm" name="id2594689"></a><pre class="programlisting">void gconf_entry_set_is_default (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry,
gboolean is_default);</pre>
<p>
Sets the is_default field of the <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> to the boolean value passed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>is_default</code></em> :</span></td>
<td>the boolean value to be set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2594771"></a><h3>
<a name="gconf-entry-set-is-writable"></a>gconf_entry_set_is_writable ()</h3>
<a class="indexterm" name="id2594784"></a><pre class="programlisting">void gconf_entry_set_is_writable (<a href="gconf-gconf-value.html#GConfEntry">GConfEntry</a> *entry,
gboolean is_writable);</pre>
<p>
Sets the is_writable field of the <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a> to the boolean value passed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
<td>a <a href="gconf-gconf-value.html#GConfEntry"><span class="type">GConfEntry</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>is_writable</code></em> :</span></td>
<td>a boolean value.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle">
<td align="left"><a accesskey="p" href="gconf-gconf-sources.html"><b><< gconf-sources</b></a></td>
<td align="right"><a accesskey="n" href="gconf-gconf.html"><b>GConf Core Interfaces >></b></a></td>
</tr></table>
</body>
</html>