← Back to branch summary

~ubuntu-branches/debian/squeeze/glib2.0/squeeze

« back to all changes in this revision

Viewing changes to docs/reference/glib/html/glib-Datasets.html

  • Committer: Bazaar Package Importer
  • Author(s): Gustavo Noronha Silva
  • Date: 2009-02-15 13:00:43 UTC
  • mfrom: (1.3.1 upstream) (69.1.10 intrepid)
  • Revision ID: james.westby@ubuntu.com-20090215130043-q47fbt3owmt42m2f
Tags: 2.18.4-2
* Release to unstable
* debian/rules:
- bump SHVER, since we are already forcing a 2.18.0 dependecy on the
  symbols introduced in the development versions
* debian/control.in:
- added Homepage and Vcs-* control fields

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/glib/html/glib-Datasets.html
1
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
2
<html>
3
3
<head>
4
 
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>Datasets</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
 
<link rel="start" href="index.html" title="GLib Reference Manual">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
 
7
<link rel="home" href="index.html" title="GLib Reference Manual">
8
8
<link rel="up" href="glib-data-types.html" title="GLib Data Types">
9
9
<link rel="prev" href="glib-Keyed-Data-Lists.html" title="Keyed Data Lists">
10
10
<link rel="next" href="glib-Relations-and-Tuples.html" title="Relations and Tuples">
11
 
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="glib.html" title="GLib Overview">
14
14
<link rel="chapter" href="glib-fundamentals.html" title="GLib Fundamentals">
26
26
<link rel="index" href="ix08.html" title="Index of new symbols in 2.12">
27
27
<link rel="index" href="ix09.html" title="Index of new symbols in 2.14">
28
28
<link rel="index" href="ix10.html" title="Index of new symbols in 2.16">
 
29
<link rel="index" href="ix11.html" title="Index of new symbols in 2.18">
29
30
</head>
30
31
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
31
32
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
36
37
<th width="100%" align="center">GLib Reference Manual</th>
37
38
<td><a accesskey="n" href="glib-Relations-and-Tuples.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
38
39
</tr>
39
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3414777" class="shortcut">Top</a>
40
 
                  &#160;|&#160;
41
 
                  <a href="#id3415088" class="shortcut">Description</a></nobr></td></tr>
 
40
<tr><td colspan="5" class="shortcuts">
 
41
<a href="#glib-Datasets.synopsis" class="shortcut">Top</a>
 
42
                 | 
 
43
                <a href="#glib-Datasets.description" class="shortcut">Description</a>
 
44
</td></tr>
42
45
</table>
43
46
<div class="refentry" lang="en">
44
47
<a name="glib-Datasets"></a><div class="titlepage"></div>
45
48
<div class="refnamediv"><table width="100%"><tr>
46
49
<td valign="top">
47
 
<h2>
48
 
<a name="id3414777"></a><span class="refentrytitle">Datasets</span>
49
 
</h2>
50
 
<p>Datasets &#8212; associate groups of data elements with particular memory locations</p>
 
50
<h2><span class="refentrytitle"><a name="glib-Datasets.top_of_page"></a>Datasets</span></h2>
 
51
<p>Datasets — associate groups of data elements with particular memory locations</p>
51
52
</td>
52
53
<td valign="top" align="right"></td>
53
54
</tr></table></div>
54
55
<div class="refsynopsisdiv">
55
 
<h2>Synopsis</h2>
 
56
<a name="glib-Datasets.synopsis"></a><h2>Synopsis</h2>
56
57
<pre class="synopsis">
57
58
 
58
59
#include &lt;glib.h&gt;
59
60
 
60
 
 
61
 
#define             <a class="link" href="glib-Datasets.html#g-dataset-id-set-data">g_dataset_id_set_data</a>               (l, k, d)
62
 
void                <a class="link" href="glib-Datasets.html#g-dataset-id-set-data-full">g_dataset_id_set_data_full</a>          (<a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> dataset_location,
63
 
                                                         <a class="link" href="glib-Quarks.html#GQuark">GQuark</a> key_id,
64
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data,
65
 
                                                         <a class="link" href="glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_func);
66
 
void                (<a class="link" href="glib-Datasets.html#GDestroyNotify">*GDestroyNotify</a>)                   (<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);
67
 
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a>            <a class="link" href="glib-Datasets.html#g-dataset-id-get-data">g_dataset_id_get_data</a>               (<a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> dataset_location,
68
 
                                                         <a class="link" href="glib-Quarks.html#GQuark">GQuark</a> key_id);
69
 
#define             <a class="link" href="glib-Datasets.html#g-dataset-id-remove-data">g_dataset_id_remove_data</a>            (l, k)
70
 
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a>            <a class="link" href="glib-Datasets.html#g-dataset-id-remove-no-notify">g_dataset_id_remove_no_notify</a>       (<a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> dataset_location,
71
 
                                                         <a class="link" href="glib-Quarks.html#GQuark">GQuark</a> key_id);
72
 
 
73
 
#define             <a class="link" href="glib-Datasets.html#g-dataset-set-data">g_dataset_set_data</a>                  (l, k, d)
74
 
#define             <a class="link" href="glib-Datasets.html#g-dataset-set-data-full">g_dataset_set_data_full</a>             (l, k, d, f)
75
 
#define             <a class="link" href="glib-Datasets.html#g-dataset-get-data">g_dataset_get_data</a>                  (l, k)
76
 
#define             <a class="link" href="glib-Datasets.html#g-dataset-remove-data">g_dataset_remove_data</a>               (l, k)
77
 
#define             <a class="link" href="glib-Datasets.html#g-dataset-remove-no-notify">g_dataset_remove_no_notify</a>          (l, k)
78
 
 
79
 
void                <a class="link" href="glib-Datasets.html#g-dataset-foreach">g_dataset_foreach</a>                   (<a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> dataset_location,
80
 
                                                         <a class="link" href="glib-Datasets.html#GDataForeachFunc">GDataForeachFunc</a> func,
81
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);
82
 
void                (<a class="link" href="glib-Datasets.html#GDataForeachFunc">*GDataForeachFunc</a>)                 (<a class="link" href="glib-Quarks.html#GQuark">GQuark</a> key_id,
83
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data,
84
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);
85
 
void                <a class="link" href="glib-Datasets.html#g-dataset-destroy">g_dataset_destroy</a>                   (<a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> dataset_location);
 
61
#define             <a class="link" href="glib-Datasets.html#g-dataset-id-set-data" title="g_dataset_id_set_data()">g_dataset_id_set_data</a>               (l, k, d)
 
62
void                <a class="link" href="glib-Datasets.html#g-dataset-id-set-data-full" title="g_dataset_id_set_data_full ()">g_dataset_id_set_data_full</a>          (<a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> dataset_location,
 
63
                                                         <a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id,
 
64
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
 
65
                                                         <a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()">GDestroyNotify</a> destroy_func);
 
66
void                (<a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()">*GDestroyNotify</a>)                   (<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);
 
67
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a>            <a class="link" href="glib-Datasets.html#g-dataset-id-get-data" title="g_dataset_id_get_data ()">g_dataset_id_get_data</a>               (<a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> dataset_location,
 
68
                                                         <a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id);
 
69
#define             <a class="link" href="glib-Datasets.html#g-dataset-id-remove-data" title="g_dataset_id_remove_data()">g_dataset_id_remove_data</a>            (l, k)
 
70
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a>            <a class="link" href="glib-Datasets.html#g-dataset-id-remove-no-notify" title="g_dataset_id_remove_no_notify ()">g_dataset_id_remove_no_notify</a>       (<a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> dataset_location,
 
71
                                                         <a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id);
 
72
 
 
73
#define             <a class="link" href="glib-Datasets.html#g-dataset-set-data" title="g_dataset_set_data()">g_dataset_set_data</a>                  (l, k, d)
 
74
#define             <a class="link" href="glib-Datasets.html#g-dataset-set-data-full" title="g_dataset_set_data_full()">g_dataset_set_data_full</a>             (l, k, d, f)
 
75
#define             <a class="link" href="glib-Datasets.html#g-dataset-get-data" title="g_dataset_get_data()">g_dataset_get_data</a>                  (l, k)
 
76
#define             <a class="link" href="glib-Datasets.html#g-dataset-remove-data" title="g_dataset_remove_data()">g_dataset_remove_data</a>               (l, k)
 
77
#define             <a class="link" href="glib-Datasets.html#g-dataset-remove-no-notify" title="g_dataset_remove_no_notify()">g_dataset_remove_no_notify</a>          (l, k)
 
78
 
 
79
void                <a class="link" href="glib-Datasets.html#g-dataset-foreach" title="g_dataset_foreach ()">g_dataset_foreach</a>                   (<a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> dataset_location,
 
80
                                                         <a class="link" href="glib-Datasets.html#GDataForeachFunc" title="GDataForeachFunc ()">GDataForeachFunc</a> func,
 
81
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);
 
82
void                (<a class="link" href="glib-Datasets.html#GDataForeachFunc" title="GDataForeachFunc ()">*GDataForeachFunc</a>)                 (<a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id,
 
83
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
 
84
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);
 
85
void                <a class="link" href="glib-Datasets.html#g-dataset-destroy" title="g_dataset_destroy ()">g_dataset_destroy</a>                   (<a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> dataset_location);
86
86
</pre>
87
87
</div>
88
88
<div class="refsect1" lang="en">
89
 
<a name="id3415088"></a><h2>Description</h2>
 
89
<a name="glib-Datasets.description"></a><h2>Description</h2>
90
90
<p>
91
91
Datasets associate groups of data elements with particular memory locations.
92
92
These are useful if you need to associate data with a structure returned
97
97
<p>
98
98
There are two forms of most of the dataset functions.
99
99
The first form uses strings to identify the data elements associated with
100
 
a location. The second form uses <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> identifiers, which are created
101
 
with a call to <a class="link" href="glib-Quarks.html#g-quark-from-string"><code class="function">g_quark_from_string()</code></a> or <a class="link" href="glib-Quarks.html#g-quark-from-static-string"><code class="function">g_quark_from_static_string()</code></a>.
 
100
a location. The second form uses <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> identifiers, which are created
 
101
with a call to <a class="link" href="glib-Quarks.html#g-quark-from-string" title="g_quark_from_string ()"><code class="function">g_quark_from_string()</code></a> or <a class="link" href="glib-Quarks.html#g-quark-from-static-string" title="g_quark_from_static_string ()"><code class="function">g_quark_from_static_string()</code></a>.
102
102
The second form is quicker, since it does not require looking up the string
103
 
in the hash table of <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> identifiers.
 
103
in the hash table of <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> identifiers.
104
104
</p>
105
105
<p>
106
106
There is no function to create a dataset. It is automatically created as
107
107
soon as you add elements to it.
108
108
</p>
109
109
<p>
110
 
To add data elements to a dataset use <a class="link" href="glib-Datasets.html#g-dataset-id-set-data"><code class="function">g_dataset_id_set_data()</code></a>,
111
 
<a class="link" href="glib-Datasets.html#g-dataset-id-set-data-full"><code class="function">g_dataset_id_set_data_full()</code></a>, <a class="link" href="glib-Datasets.html#g-dataset-set-data"><code class="function">g_dataset_set_data()</code></a>
112
 
and <a class="link" href="glib-Datasets.html#g-dataset-set-data-full"><code class="function">g_dataset_set_data_full()</code></a>.
113
 
</p>
114
 
<p>
115
 
To get data elements from a dataset use <a class="link" href="glib-Datasets.html#g-dataset-id-get-data"><code class="function">g_dataset_id_get_data()</code></a> and
116
 
<a class="link" href="glib-Datasets.html#g-dataset-get-data"><code class="function">g_dataset_get_data()</code></a>.
117
 
</p>
118
 
<p>
119
 
To iterate over all data elements in a dataset use <a class="link" href="glib-Datasets.html#g-dataset-foreach"><code class="function">g_dataset_foreach()</code></a> (not thread-safe).
120
 
</p>
121
 
<p>
122
 
To remove data elements from a dataset use <a class="link" href="glib-Datasets.html#g-dataset-id-remove-data"><code class="function">g_dataset_id_remove_data()</code></a> and
123
 
<a class="link" href="glib-Datasets.html#g-dataset-remove-data"><code class="function">g_dataset_remove_data()</code></a>.
124
 
</p>
125
 
<p>
126
 
To destroy a dataset, use <a class="link" href="glib-Datasets.html#g-dataset-destroy"><code class="function">g_dataset_destroy()</code></a>.
 
110
To add data elements to a dataset use <a class="link" href="glib-Datasets.html#g-dataset-id-set-data" title="g_dataset_id_set_data()"><code class="function">g_dataset_id_set_data()</code></a>,
 
111
<a class="link" href="glib-Datasets.html#g-dataset-id-set-data-full" title="g_dataset_id_set_data_full ()"><code class="function">g_dataset_id_set_data_full()</code></a>, <a class="link" href="glib-Datasets.html#g-dataset-set-data" title="g_dataset_set_data()"><code class="function">g_dataset_set_data()</code></a>
 
112
and <a class="link" href="glib-Datasets.html#g-dataset-set-data-full" title="g_dataset_set_data_full()"><code class="function">g_dataset_set_data_full()</code></a>.
 
113
</p>
 
114
<p>
 
115
To get data elements from a dataset use <a class="link" href="glib-Datasets.html#g-dataset-id-get-data" title="g_dataset_id_get_data ()"><code class="function">g_dataset_id_get_data()</code></a> and
 
116
<a class="link" href="glib-Datasets.html#g-dataset-get-data" title="g_dataset_get_data()"><code class="function">g_dataset_get_data()</code></a>.
 
117
</p>
 
118
<p>
 
119
To iterate over all data elements in a dataset use <a class="link" href="glib-Datasets.html#g-dataset-foreach" title="g_dataset_foreach ()"><code class="function">g_dataset_foreach()</code></a> (not thread-safe).
 
120
</p>
 
121
<p>
 
122
To remove data elements from a dataset use <a class="link" href="glib-Datasets.html#g-dataset-id-remove-data" title="g_dataset_id_remove_data()"><code class="function">g_dataset_id_remove_data()</code></a> and
 
123
<a class="link" href="glib-Datasets.html#g-dataset-remove-data" title="g_dataset_remove_data()"><code class="function">g_dataset_remove_data()</code></a>.
 
124
</p>
 
125
<p>
 
126
To destroy a dataset, use <a class="link" href="glib-Datasets.html#g-dataset-destroy" title="g_dataset_destroy ()"><code class="function">g_dataset_destroy()</code></a>.
127
127
</p>
128
128
</div>
129
129
<div class="refsect1" lang="en">
130
 
<a name="id3415293"></a><h2>Details</h2>
 
130
<a name="glib-Datasets.details"></a><h2>Details</h2>
131
131
<div class="refsect2" lang="en">
132
 
<a name="id3415303"></a><h3>
133
 
<a name="g-dataset-id-set-data"></a>g_dataset_id_set_data()</h3>
134
 
<a class="indexterm" name="id3415316"></a><pre class="programlisting">#define             g_dataset_id_set_data(l, k, d)</pre>
 
132
<a name="g-dataset-id-set-data"></a><h3>g_dataset_id_set_data()</h3>
 
133
<pre class="programlisting">#define             g_dataset_id_set_data(l, k, d)</pre>
135
134
<p>
136
 
Sets the data element associated with the given <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> id.
 
135
Sets the data element associated with the given <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> id.
137
136
Any previous data with the same key is removed, and its destroy function
138
137
is called.
139
138
</p>
141
140
<col align="left" valign="top">
142
141
<tbody>
143
142
<tr>
144
 
<td><p><span class="term"><em class="parameter"><code>l</code></em>&#160;:</span></p></td>
 
143
<td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
145
144
<td>the location identifying the dataset.
146
145
</td>
147
146
</tr>
148
147
<tr>
149
 
<td><p><span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></p></td>
150
 
<td>the <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> id to identify the data element.
 
148
<td><p><span class="term"><em class="parameter"><code>k</code></em> :</span></p></td>
 
149
<td>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> id to identify the data element.
151
150
</td>
152
151
</tr>
153
152
<tr>
154
 
<td><p><span class="term"><em class="parameter"><code>d</code></em>&#160;:</span></p></td>
 
153
<td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
155
154
<td>the data element.
156
 
 
157
 
 
158
155
</td>
159
156
</tr>
160
157
</tbody>
162
159
</div>
163
160
<hr>
164
161
<div class="refsect2" lang="en">
165
 
<a name="id3415396"></a><h3>
166
 
<a name="g-dataset-id-set-data-full"></a>g_dataset_id_set_data_full ()</h3>
167
 
<a class="indexterm" name="id3415410"></a><pre class="programlisting">void                g_dataset_id_set_data_full          (<a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> dataset_location,
168
 
                                                         <a class="link" href="glib-Quarks.html#GQuark">GQuark</a> key_id,
169
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data,
170
 
                                                         <a class="link" href="glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_func);</pre>
 
162
<a name="g-dataset-id-set-data-full"></a><h3>g_dataset_id_set_data_full ()</h3>
 
163
<pre class="programlisting">void                g_dataset_id_set_data_full          (<a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> dataset_location,
 
164
                                                         <a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id,
 
165
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
 
166
                                                         <a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()">GDestroyNotify</a> destroy_func);</pre>
171
167
<p>
172
 
Sets the data element associated with the given <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> id, and also the
 
168
Sets the data element associated with the given <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> id, and also the
173
169
function to call when the data element is destroyed.
174
170
Any previous data with the same key is removed, and its
175
171
destroy function is called.
178
174
<col align="left" valign="top">
179
175
<tbody>
180
176
<tr>
181
 
<td><p><span class="term"><em class="parameter"><code>dataset_location</code></em>&#160;:</span></p></td>
 
177
<td><p><span class="term"><em class="parameter"><code>dataset_location</code></em> :</span></p></td>
182
178
<td>the location identifying the dataset.
183
179
</td>
184
180
</tr>
185
181
<tr>
186
 
<td><p><span class="term"><em class="parameter"><code>key_id</code></em>&#160;:</span></p></td>
187
 
<td>the <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> id to identify the data element.
 
182
<td><p><span class="term"><em class="parameter"><code>key_id</code></em> :</span></p></td>
 
183
<td>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> id to identify the data element.
188
184
</td>
189
185
</tr>
190
186
<tr>
191
 
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
 
187
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
192
188
<td>the data element.
193
189
</td>
194
190
</tr>
195
191
<tr>
196
 
<td><p><span class="term"><em class="parameter"><code>destroy_func</code></em>&#160;:</span></p></td>
 
192
<td><p><span class="term"><em class="parameter"><code>destroy_func</code></em> :</span></p></td>
197
193
<td>the function to call when the data element is removed. This
198
194
function will be called with the data element and can be used to free any
199
195
memory allocated for it.
200
 
 
201
 
 
202
196
</td>
203
197
</tr>
204
198
</tbody>
206
200
</div>
207
201
<hr>
208
202
<div class="refsect2" lang="en">
209
 
<a name="id3415545"></a><h3>
210
 
<a name="GDestroyNotify"></a>GDestroyNotify ()</h3>
211
 
<a class="indexterm" name="id3415558"></a><pre class="programlisting">void                (*GDestroyNotify)                   (<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);</pre>
 
203
<a name="GDestroyNotify"></a><h3>GDestroyNotify ()</h3>
 
204
<pre class="programlisting">void                (*GDestroyNotify)                   (<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);</pre>
212
205
<p>
213
206
Specifies the type of function which is called when a data element is
214
207
destroyed. It is passed the pointer to the data element and should free
217
210
<div class="variablelist"><table border="0">
218
211
<col align="left" valign="top">
219
212
<tbody><tr>
220
 
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
 
213
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
221
214
<td>the data element.
222
 
 
223
 
 
224
215
</td>
225
216
</tr></tbody>
226
217
</table></div>
227
218
</div>
228
219
<hr>
229
220
<div class="refsect2" lang="en">
230
 
<a name="id3415608"></a><h3>
231
 
<a name="g-dataset-id-get-data"></a>g_dataset_id_get_data ()</h3>
232
 
<a class="indexterm" name="id3415621"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a>            g_dataset_id_get_data               (<a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> dataset_location,
233
 
                                                         <a class="link" href="glib-Quarks.html#GQuark">GQuark</a> key_id);</pre>
 
221
<a name="g-dataset-id-get-data"></a><h3>g_dataset_id_get_data ()</h3>
 
222
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a>            g_dataset_id_get_data               (<a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> dataset_location,
 
223
                                                         <a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id);</pre>
234
224
<p>
235
 
Gets the data element corresponding to a <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a>.
 
225
Gets the data element corresponding to a <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a>.
236
226
</p>
237
227
<div class="variablelist"><table border="0">
238
228
<col align="left" valign="top">
239
229
<tbody>
240
230
<tr>
241
 
<td><p><span class="term"><em class="parameter"><code>dataset_location</code></em>&#160;:</span></p></td>
 
231
<td><p><span class="term"><em class="parameter"><code>dataset_location</code></em> :</span></p></td>
242
232
<td>the location identifying the dataset.
243
233
</td>
244
234
</tr>
245
235
<tr>
246
 
<td><p><span class="term"><em class="parameter"><code>key_id</code></em>&#160;:</span></p></td>
247
 
<td>the <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> id to identify the data element.
 
236
<td><p><span class="term"><em class="parameter"><code>key_id</code></em> :</span></p></td>
 
237
<td>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> id to identify the data element.
248
238
</td>
249
239
</tr>
250
240
<tr>
251
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
252
 
<td>the data element corresponding to the <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it is
 
241
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
242
<td>the data element corresponding to the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if it is
253
243
not found.
254
 
 
255
 
 
256
244
</td>
257
245
</tr>
258
246
</tbody>
260
248
</div>
261
249
<hr>
262
250
<div class="refsect2" lang="en">
263
 
<a name="id3415737"></a><h3>
264
 
<a name="g-dataset-id-remove-data"></a>g_dataset_id_remove_data()</h3>
265
 
<a class="indexterm" name="id3415750"></a><pre class="programlisting">#define             g_dataset_id_remove_data(l, k)</pre>
 
251
<a name="g-dataset-id-remove-data"></a><h3>g_dataset_id_remove_data()</h3>
 
252
<pre class="programlisting">#define             g_dataset_id_remove_data(l, k)</pre>
266
253
<p>
267
254
Removes a data element from a dataset.
268
255
The data element's destroy function is called if it has been set.
271
258
<col align="left" valign="top">
272
259
<tbody>
273
260
<tr>
274
 
<td><p><span class="term"><em class="parameter"><code>l</code></em>&#160;:</span></p></td>
 
261
<td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
275
262
<td>the location identifying the dataset.
276
263
</td>
277
264
</tr>
278
265
<tr>
279
 
<td><p><span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></p></td>
280
 
<td>the <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> id identifying the data element.
281
 
 
282
 
 
 
266
<td><p><span class="term"><em class="parameter"><code>k</code></em> :</span></p></td>
 
267
<td>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> id identifying the data element.
283
268
</td>
284
269
</tr>
285
270
</tbody>
287
272
</div>
288
273
<hr>
289
274
<div class="refsect2" lang="en">
290
 
<a name="id3415808"></a><h3>
291
 
<a name="g-dataset-id-remove-no-notify"></a>g_dataset_id_remove_no_notify ()</h3>
292
 
<a class="indexterm" name="id3415821"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a>            g_dataset_id_remove_no_notify       (<a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> dataset_location,
293
 
                                                         <a class="link" href="glib-Quarks.html#GQuark">GQuark</a> key_id);</pre>
 
275
<a name="g-dataset-id-remove-no-notify"></a><h3>g_dataset_id_remove_no_notify ()</h3>
 
276
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a>            g_dataset_id_remove_no_notify       (<a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> dataset_location,
 
277
                                                         <a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id);</pre>
294
278
<p>
295
279
Removes an element, without calling its destroy notification function.
296
280
</p>
298
282
<col align="left" valign="top">
299
283
<tbody>
300
284
<tr>
301
 
<td><p><span class="term"><em class="parameter"><code>dataset_location</code></em>&#160;:</span></p></td>
 
285
<td><p><span class="term"><em class="parameter"><code>dataset_location</code></em> :</span></p></td>
302
286
<td>the location identifying the dataset.
303
287
</td>
304
288
</tr>
305
289
<tr>
306
 
<td><p><span class="term"><em class="parameter"><code>key_id</code></em>&#160;:</span></p></td>
307
 
<td>the <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> ID identifying the data element.
 
290
<td><p><span class="term"><em class="parameter"><code>key_id</code></em> :</span></p></td>
 
291
<td>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> ID identifying the data element.
308
292
</td>
309
293
</tr>
310
294
<tr>
311
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
312
 
<td>the data previously stored at <em class="parameter"><code>key_id</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none.
313
 
 
314
 
 
 
295
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
296
<td>the data previously stored at <em class="parameter"><code>key_id</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if none.
315
297
</td>
316
298
</tr>
317
299
</tbody>
319
301
</div>
320
302
<hr>
321
303
<div class="refsect2" lang="en">
322
 
<a name="id3415928"></a><h3>
323
 
<a name="g-dataset-set-data"></a>g_dataset_set_data()</h3>
324
 
<a class="indexterm" name="id3415941"></a><pre class="programlisting">#define             g_dataset_set_data(l, k, d)</pre>
 
304
<a name="g-dataset-set-data"></a><h3>g_dataset_set_data()</h3>
 
305
<pre class="programlisting">#define             g_dataset_set_data(l, k, d)</pre>
325
306
<p>
326
307
Sets the data corresponding to the given string identifier.
327
308
</p>
329
310
<col align="left" valign="top">
330
311
<tbody>
331
312
<tr>
332
 
<td><p><span class="term"><em class="parameter"><code>l</code></em>&#160;:</span></p></td>
 
313
<td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
333
314
<td>the location identifying the dataset.
334
315
</td>
335
316
</tr>
336
317
<tr>
337
 
<td><p><span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></p></td>
 
318
<td><p><span class="term"><em class="parameter"><code>k</code></em> :</span></p></td>
338
319
<td>the string to identify the data element.
339
320
</td>
340
321
</tr>
341
322
<tr>
342
 
<td><p><span class="term"><em class="parameter"><code>d</code></em>&#160;:</span></p></td>
 
323
<td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
343
324
<td>the data element.
344
 
 
345
 
 
346
325
</td>
347
326
</tr>
348
327
</tbody>
350
329
</div>
351
330
<hr>
352
331
<div class="refsect2" lang="en">
353
 
<a name="id3416003"></a><h3>
354
 
<a name="g-dataset-set-data-full"></a>g_dataset_set_data_full()</h3>
355
 
<a class="indexterm" name="id3416016"></a><pre class="programlisting">#define             g_dataset_set_data_full(l, k, d, f)</pre>
 
332
<a name="g-dataset-set-data-full"></a><h3>g_dataset_set_data_full()</h3>
 
333
<pre class="programlisting">#define             g_dataset_set_data_full(l, k, d, f)</pre>
356
334
<p>
357
335
Sets the data corresponding to the given string identifier, and the function
358
336
to call when the data element is destroyed.
361
339
<col align="left" valign="top">
362
340
<tbody>
363
341
<tr>
364
 
<td><p><span class="term"><em class="parameter"><code>l</code></em>&#160;:</span></p></td>
 
342
<td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
365
343
<td>the location identifying the dataset.
366
344
</td>
367
345
</tr>
368
346
<tr>
369
 
<td><p><span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></p></td>
 
347
<td><p><span class="term"><em class="parameter"><code>k</code></em> :</span></p></td>
370
348
<td>the string to identify the data element.
371
349
</td>
372
350
</tr>
373
351
<tr>
374
 
<td><p><span class="term"><em class="parameter"><code>d</code></em>&#160;:</span></p></td>
 
352
<td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
375
353
<td>the data element.
376
354
</td>
377
355
</tr>
378
356
<tr>
379
 
<td><p><span class="term"><em class="parameter"><code>f</code></em>&#160;:</span></p></td>
 
357
<td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
380
358
<td>the function to call when the data element is removed. This
381
359
function will be called with the data element and can be used to free any
382
360
memory allocated for it.
383
 
 
384
 
 
385
361
</td>
386
362
</tr>
387
363
</tbody>
389
365
</div>
390
366
<hr>
391
367
<div class="refsect2" lang="en">
392
 
<a name="id3416096"></a><h3>
393
 
<a name="g-dataset-get-data"></a>g_dataset_get_data()</h3>
394
 
<a class="indexterm" name="id3416109"></a><pre class="programlisting">#define             g_dataset_get_data(l, k)</pre>
 
368
<a name="g-dataset-get-data"></a><h3>g_dataset_get_data()</h3>
 
369
<pre class="programlisting">#define             g_dataset_get_data(l, k)</pre>
395
370
<p>
396
371
Gets the data element corresponding to a string.
397
372
</p>
399
374
<col align="left" valign="top">
400
375
<tbody>
401
376
<tr>
402
 
<td><p><span class="term"><em class="parameter"><code>l</code></em>&#160;:</span></p></td>
 
377
<td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
403
378
<td>the location identifying the dataset.
404
379
</td>
405
380
</tr>
406
381
<tr>
407
 
<td><p><span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></p></td>
 
382
<td><p><span class="term"><em class="parameter"><code>k</code></em> :</span></p></td>
408
383
<td>the string identifying the data element.
409
384
</td>
410
385
</tr>
411
386
<tr>
412
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
413
 
<td>the data element corresponding to the string, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it is not
 
387
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
388
<td>the data element corresponding to the string, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if it is not
414
389
found.
415
 
 
416
 
 
417
390
</td>
418
391
</tr>
419
392
</tbody>
421
394
</div>
422
395
<hr>
423
396
<div class="refsect2" lang="en">
424
 
<a name="id3416180"></a><h3>
425
 
<a name="g-dataset-remove-data"></a>g_dataset_remove_data()</h3>
426
 
<a class="indexterm" name="id3416193"></a><pre class="programlisting">#define             g_dataset_remove_data(l, k)</pre>
 
397
<a name="g-dataset-remove-data"></a><h3>g_dataset_remove_data()</h3>
 
398
<pre class="programlisting">#define             g_dataset_remove_data(l, k)</pre>
427
399
<p>
428
400
Removes a data element corresponding to a string.
429
401
Its destroy function is called if it has been set.
432
404
<col align="left" valign="top">
433
405
<tbody>
434
406
<tr>
435
 
<td><p><span class="term"><em class="parameter"><code>l</code></em>&#160;:</span></p></td>
 
407
<td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
436
408
<td>the location identifying the dataset.
437
409
</td>
438
410
</tr>
439
411
<tr>
440
 
<td><p><span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></p></td>
 
412
<td><p><span class="term"><em class="parameter"><code>k</code></em> :</span></p></td>
441
413
<td>the string identifying the data element.
442
 
 
443
 
 
444
414
</td>
445
415
</tr>
446
416
</tbody>
448
418
</div>
449
419
<hr>
450
420
<div class="refsect2" lang="en">
451
 
<a name="id3416243"></a><h3>
452
 
<a name="g-dataset-remove-no-notify"></a>g_dataset_remove_no_notify()</h3>
453
 
<a class="indexterm" name="id3416257"></a><pre class="programlisting">#define             g_dataset_remove_no_notify(l, k)</pre>
 
421
<a name="g-dataset-remove-no-notify"></a><h3>g_dataset_remove_no_notify()</h3>
 
422
<pre class="programlisting">#define             g_dataset_remove_no_notify(l, k)</pre>
454
423
<p>
455
424
Removes an element, without calling its destroy notifier.
456
425
</p>
458
427
<col align="left" valign="top">
459
428
<tbody>
460
429
<tr>
461
 
<td><p><span class="term"><em class="parameter"><code>l</code></em>&#160;:</span></p></td>
 
430
<td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
462
431
<td>the location identifying the dataset.
463
432
</td>
464
433
</tr>
465
434
<tr>
466
 
<td><p><span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></p></td>
 
435
<td><p><span class="term"><em class="parameter"><code>k</code></em> :</span></p></td>
467
436
<td>the string identifying the data element.
468
 
 
469
 
 
470
437
</td>
471
438
</tr>
472
439
</tbody>
474
441
</div>
475
442
<hr>
476
443
<div class="refsect2" lang="en">
477
 
<a name="id3416306"></a><h3>
478
 
<a name="g-dataset-foreach"></a>g_dataset_foreach ()</h3>
479
 
<a class="indexterm" name="id3416319"></a><pre class="programlisting">void                g_dataset_foreach                   (<a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> dataset_location,
480
 
                                                         <a class="link" href="glib-Datasets.html#GDataForeachFunc">GDataForeachFunc</a> func,
481
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
 
444
<a name="g-dataset-foreach"></a><h3>g_dataset_foreach ()</h3>
 
445
<pre class="programlisting">void                g_dataset_foreach                   (<a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> dataset_location,
 
446
                                                         <a class="link" href="glib-Datasets.html#GDataForeachFunc" title="GDataForeachFunc ()">GDataForeachFunc</a> func,
 
447
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);</pre>
482
448
<p>
483
449
Calls the given function for each data element which is associated with the
484
450
given location.
490
456
<col align="left" valign="top">
491
457
<tbody>
492
458
<tr>
493
 
<td><p><span class="term"><em class="parameter"><code>dataset_location</code></em>&#160;:</span></p></td>
 
459
<td><p><span class="term"><em class="parameter"><code>dataset_location</code></em> :</span></p></td>
494
460
<td>the location identifying the dataset.
495
461
</td>
496
462
</tr>
497
463
<tr>
498
 
<td><p><span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></p></td>
 
464
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
499
465
<td>the function to call for each data element.
500
466
</td>
501
467
</tr>
502
468
<tr>
503
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
 
469
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
504
470
<td>user data to pass to the function.
505
 
 
506
 
 
507
471
</td>
508
472
</tr>
509
473
</tbody>
511
475
</div>
512
476
<hr>
513
477
<div class="refsect2" lang="en">
514
 
<a name="id3416422"></a><h3>
515
 
<a name="GDataForeachFunc"></a>GDataForeachFunc ()</h3>
516
 
<a class="indexterm" name="id3416434"></a><pre class="programlisting">void                (*GDataForeachFunc)                 (<a class="link" href="glib-Quarks.html#GQuark">GQuark</a> key_id,
517
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data,
518
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
 
478
<a name="GDataForeachFunc"></a><h3>GDataForeachFunc ()</h3>
 
479
<pre class="programlisting">void                (*GDataForeachFunc)                 (<a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id,
 
480
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
 
481
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);</pre>
519
482
<p>
520
 
Specifies the type of function passed to <a class="link" href="glib-Datasets.html#g-dataset-foreach"><code class="function">g_dataset_foreach()</code></a>.
521
 
It is called with each <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> id and associated data element,
522
 
together with the <em class="parameter"><code>user_data</code></em> parameter supplied to <a class="link" href="glib-Datasets.html#g-dataset-foreach"><code class="function">g_dataset_foreach()</code></a>.
 
483
Specifies the type of function passed to <a class="link" href="glib-Datasets.html#g-dataset-foreach" title="g_dataset_foreach ()"><code class="function">g_dataset_foreach()</code></a>.
 
484
It is called with each <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> id and associated data element,
 
485
together with the <em class="parameter"><code>user_data</code></em> parameter supplied to <a class="link" href="glib-Datasets.html#g-dataset-foreach" title="g_dataset_foreach ()"><code class="function">g_dataset_foreach()</code></a>.
523
486
</p>
524
487
<div class="variablelist"><table border="0">
525
488
<col align="left" valign="top">
526
489
<tbody>
527
490
<tr>
528
 
<td><p><span class="term"><em class="parameter"><code>key_id</code></em>&#160;:</span></p></td>
529
 
<td>the <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> id to identifying the data element.
 
491
<td><p><span class="term"><em class="parameter"><code>key_id</code></em> :</span></p></td>
 
492
<td>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> id to identifying the data element.
530
493
</td>
531
494
</tr>
532
495
<tr>
533
 
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
 
496
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
534
497
<td>the data element.
535
498
</td>
536
499
</tr>
537
500
<tr>
538
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
539
 
<td>user data passed to <a class="link" href="glib-Datasets.html#g-dataset-foreach"><code class="function">g_dataset_foreach()</code></a>.
540
 
 
541
 
 
 
501
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
502
<td>user data passed to <a class="link" href="glib-Datasets.html#g-dataset-foreach" title="g_dataset_foreach ()"><code class="function">g_dataset_foreach()</code></a>.
542
503
</td>
543
504
</tr>
544
505
</tbody>
546
507
</div>
547
508
<hr>
548
509
<div class="refsect2" lang="en">
549
 
<a name="id3416581"></a><h3>
550
 
<a name="g-dataset-destroy"></a>g_dataset_destroy ()</h3>
551
 
<a class="indexterm" name="id3416594"></a><pre class="programlisting">void                g_dataset_destroy                   (<a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> dataset_location);</pre>
 
510
<a name="g-dataset-destroy"></a><h3>g_dataset_destroy ()</h3>
 
511
<pre class="programlisting">void                g_dataset_destroy                   (<a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> dataset_location);</pre>
552
512
<p>
553
513
Destroys the dataset, freeing all memory allocated, and calling any
554
514
destroy functions set for data elements.
556
516
<div class="variablelist"><table border="0">
557
517
<col align="left" valign="top">
558
518
<tbody><tr>
559
 
<td><p><span class="term"><em class="parameter"><code>dataset_location</code></em>&#160;:</span></p></td>
 
519
<td><p><span class="term"><em class="parameter"><code>dataset_location</code></em> :</span></p></td>
560
520
<td>the location identifying the dataset.
561
 
 
562
 
 
563
521
</td>
564
522
</tr></tbody>
565
523
</table></div>
566
524
</div>
567
525
</div>
568
 
<div class="refsect1" lang="en">
569
 
<a name="id3416645"></a><div class="refsect2" lang="en"><a name="id3416646"></a></div>
 
526
</div>
 
527
<div class="footer">
570
528
<hr>
571
 
<div class="refsect2" lang="en"><a name="id3416647"></a></div>
572
 
</div>
573
 
</div>
 
529
          Generated by GTK-Doc V1.11</div>
574
530
</body>
575
531
</html>