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

1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html>
3
<head>
1.2.41 by Sebastian Dröge
Import upstream version 2.17.0
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
5
<title>GLib Reference Manual: Keyed Data Lists</title>
1.65.1 by Iain Lane
Import upstream version 2.37.0
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
1.2.42 by Sebastian Dröge
Import upstream version 2.17.2
7
<link rel="home" href="index.html" title="GLib Reference Manual">
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
8
<link rel="up" href="glib-data-types.html" title="GLib Data Types">
9
<link rel="prev" href="glib-Quarks.html" title="Quarks">
10
<link rel="next" href="glib-Datasets.html" title="Datasets">
1.66.17 by Iain Lane
Import upstream version 2.41.3
11
<meta name="generator" content="GTK-Doc V1.21.1 (XML mode)">
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
</head>
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
1.66.16 by Iain Lane
Import upstream version 2.41.2
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
16
<td width="100%" align="left" class="shortcuts">
1.66.16 by Iain Lane
Import upstream version 2.41.2
17
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
18
                  <a href="#glib-Keyed-Data-Lists.description" class="shortcut">Description</a></span>
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
19
</td>
20
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
21
<td><a accesskey="u" href="glib-data-types.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
22
<td><a accesskey="p" href="glib-Quarks.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
23
<td><a accesskey="n" href="glib-Datasets.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
24
</tr></table>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
25
<div class="refentry">
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
26
<a name="glib-Keyed-Data-Lists"></a><div class="titlepage"></div>
27
<div class="refnamediv"><table width="100%"><tr>
28
<td valign="top">
1.2.41 by Sebastian Dröge
Import upstream version 2.17.0
29
<h2><span class="refentrytitle"><a name="glib-Keyed-Data-Lists.top_of_page"></a>Keyed Data Lists</span></h2>
1.8.2 by Sebastien Bacher
Import upstream version 2.23.3
30
<p>Keyed Data Lists — lists of data elements which are accessible by a
31
                    string or GQuark identifier</p>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
32
</td>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
33
<td class="gallery_image" valign="top" align="right"></td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
34
</tr></table></div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
35
<div class="refsect1">
36
<a name="glib-Keyed-Data-Lists.functions"></a><h2>Functions</h2>
37
<div class="informaltable"><table width="100%" border="0">
38
<colgroup>
39
<col width="150px" class="functions_return">
40
<col class="functions_name">
41
</colgroup>
42
<tbody>
43
<tr>
44
<td class="function_type">
45
<span class="returnvalue">void</span>
46
</td>
47
<td class="function_name">
48
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-init" title="g_datalist_init ()">g_datalist_init</a> <span class="c_punctuation">()</span>
49
</td>
50
</tr>
51
<tr>
52
<td class="define_keyword">#define</td>
53
<td class="function_name">
54
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-set-data" title="g_datalist_id_set_data()">g_datalist_id_set_data</a><span class="c_punctuation">()</span>
55
</td>
56
</tr>
57
<tr>
58
<td class="function_type">
59
<span class="returnvalue">void</span>
60
</td>
61
<td class="function_name">
62
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-set-data-full" title="g_datalist_id_set_data_full ()">g_datalist_id_set_data_full</a> <span class="c_punctuation">()</span>
63
</td>
64
</tr>
65
<tr>
66
<td class="function_type">
67
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>
68
</td>
69
<td class="function_name">
70
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-get-data" title="g_datalist_id_get_data ()">g_datalist_id_get_data</a> <span class="c_punctuation">()</span>
71
</td>
72
</tr>
73
<tr>
74
<td class="define_keyword">#define</td>
75
<td class="function_name">
76
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-remove-data" title="g_datalist_id_remove_data()">g_datalist_id_remove_data</a><span class="c_punctuation">()</span>
77
</td>
78
</tr>
79
<tr>
80
<td class="function_type">
81
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>
82
</td>
83
<td class="function_name">
84
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-remove-no-notify" title="g_datalist_id_remove_no_notify ()">g_datalist_id_remove_no_notify</a> <span class="c_punctuation">()</span>
85
</td>
86
</tr>
87
<tr>
88
<td class="function_type">
89
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>
90
</td>
91
<td class="function_name">
92
<span class="c_punctuation">(</span><a class="link" href="glib-Keyed-Data-Lists.html#GDuplicateFunc" title="GDuplicateFunc ()">*GDuplicateFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
93
</td>
94
</tr>
95
<tr>
96
<td class="function_type">
97
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>
98
</td>
99
<td class="function_name">
100
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-dup-data" title="g_datalist_id_dup_data ()">g_datalist_id_dup_data</a> <span class="c_punctuation">()</span>
101
</td>
102
</tr>
103
<tr>
104
<td class="function_type">
105
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>
106
</td>
107
<td class="function_name">
108
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-replace-data" title="g_datalist_id_replace_data ()">g_datalist_id_replace_data</a> <span class="c_punctuation">()</span>
109
</td>
110
</tr>
111
<tr>
112
<td class="define_keyword">#define</td>
113
<td class="function_name">
114
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-set-data" title="g_datalist_set_data()">g_datalist_set_data</a><span class="c_punctuation">()</span>
115
</td>
116
</tr>
117
<tr>
118
<td class="define_keyword">#define</td>
119
<td class="function_name">
120
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-set-data-full" title="g_datalist_set_data_full()">g_datalist_set_data_full</a><span class="c_punctuation">()</span>
121
</td>
122
</tr>
123
<tr>
124
<td class="function_type">
125
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>
126
</td>
127
<td class="function_name">
128
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-get-data" title="g_datalist_get_data ()">g_datalist_get_data</a> <span class="c_punctuation">()</span>
129
</td>
130
</tr>
131
<tr>
132
<td class="define_keyword">#define</td>
133
<td class="function_name">
134
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-remove-data" title="g_datalist_remove_data()">g_datalist_remove_data</a><span class="c_punctuation">()</span>
135
</td>
136
</tr>
137
<tr>
138
<td class="define_keyword">#define</td>
139
<td class="function_name">
140
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-remove-no-notify" title="g_datalist_remove_no_notify()">g_datalist_remove_no_notify</a><span class="c_punctuation">()</span>
141
</td>
142
</tr>
143
<tr>
144
<td class="function_type">
145
<span class="returnvalue">void</span>
146
</td>
147
<td class="function_name">
148
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-foreach" title="g_datalist_foreach ()">g_datalist_foreach</a> <span class="c_punctuation">()</span>
149
</td>
150
</tr>
151
<tr>
152
<td class="function_type">
153
<span class="returnvalue">void</span>
154
</td>
155
<td class="function_name">
156
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-clear" title="g_datalist_clear ()">g_datalist_clear</a> <span class="c_punctuation">()</span>
157
</td>
158
</tr>
159
<tr>
160
<td class="function_type">
161
<span class="returnvalue">void</span>
162
</td>
163
<td class="function_name">
164
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-set-flags" title="g_datalist_set_flags ()">g_datalist_set_flags</a> <span class="c_punctuation">()</span>
165
</td>
166
</tr>
167
<tr>
168
<td class="function_type">
169
<span class="returnvalue">void</span>
170
</td>
171
<td class="function_name">
172
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-unset-flags" title="g_datalist_unset_flags ()">g_datalist_unset_flags</a> <span class="c_punctuation">()</span>
173
</td>
174
</tr>
175
<tr>
176
<td class="function_type">
177
<a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>
178
</td>
179
<td class="function_name">
180
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-get-flags" title="g_datalist_get_flags ()">g_datalist_get_flags</a> <span class="c_punctuation">()</span>
181
</td>
182
</tr>
183
</tbody>
184
</table></div>
185
</div>
186
<div class="refsect1">
187
<a name="glib-Keyed-Data-Lists.other"></a><h2>Types and Values</h2>
188
<div class="informaltable"><table width="100%" border="0">
189
<colgroup>
190
<col width="150px" class="name">
191
<col class="description">
192
</colgroup>
193
<tbody>
194
<tr>
195
<td class="datatype_keyword"> </td>
196
<td class="function_name"><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData">GData</a></td>
197
</tr>
198
<tr>
199
<td class="define_keyword">#define</td>
200
<td class="function_name"><a class="link" href="glib-Keyed-Data-Lists.html#G-DATALIST-FLAGS-MASK:CAPS" title="G_DATALIST_FLAGS_MASK">G_DATALIST_FLAGS_MASK</a></td>
201
</tr>
202
</tbody>
203
</table></div>
204
</div>
205
<div class="refsect1">
206
<a name="glib-Keyed-Data-Lists.includes"></a><h2>Includes</h2>
207
<pre class="synopsis">#include &lt;glib.h&gt;
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
208
</pre>
209
</div>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
210
<div class="refsect1">
1.2.41 by Sebastian Dröge
Import upstream version 2.17.0
211
<a name="glib-Keyed-Data-Lists.description"></a><h2>Description</h2>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
212
<p>Keyed data lists provide lists of arbitrary data elements which can
1.8.2 by Sebastien Bacher
Import upstream version 2.23.3
213
be accessed either with a string or with a <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> corresponding to
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
214
the string.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
215
<p>The <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> methods are quicker, since the strings have to be
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
216
converted to <a href="glib-Quarks.html#GQuark"><span class="type">GQuarks</span></a> anyway.</p>
1.66.20 by Iain Lane
Import upstream version 2.42.0
217
<p>Data lists are used for associating arbitrary data with <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObjects</span></a>,
218
using <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-set-data"><code class="function">g_object_set_data()</code></a> and related functions.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
219
<p>To create a datalist, use <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-init" title="g_datalist_init ()"><code class="function">g_datalist_init()</code></a>.</p>
220
<p>To add data elements to a datalist use <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-set-data" title="g_datalist_id_set_data()"><code class="function">g_datalist_id_set_data()</code></a>,
221
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-set-data-full" title="g_datalist_id_set_data_full ()"><code class="function">g_datalist_id_set_data_full()</code></a>, <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-set-data" title="g_datalist_set_data()"><code class="function">g_datalist_set_data()</code></a> and
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
222
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-set-data-full" title="g_datalist_set_data_full()"><code class="function">g_datalist_set_data_full()</code></a>.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
223
<p>To get data elements from a datalist use <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-get-data" title="g_datalist_id_get_data ()"><code class="function">g_datalist_id_get_data()</code></a>
224
and <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-get-data" title="g_datalist_get_data ()"><code class="function">g_datalist_get_data()</code></a>.</p>
225
<p>To iterate over all data elements in a datalist use
226
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-foreach" title="g_datalist_foreach ()"><code class="function">g_datalist_foreach()</code></a> (not thread-safe).</p>
227
<p>To remove data elements from a datalist use
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
228
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-remove-data" title="g_datalist_id_remove_data()"><code class="function">g_datalist_id_remove_data()</code></a> and <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-remove-data" title="g_datalist_remove_data()"><code class="function">g_datalist_remove_data()</code></a>.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
229
<p>To remove all data elements from a datalist, use <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-clear" title="g_datalist_clear ()"><code class="function">g_datalist_clear()</code></a>.</p>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
230
</div>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
231
<div class="refsect1">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
232
<a name="glib-Keyed-Data-Lists.functions_details"></a><h2>Functions</h2>
233
<div class="refsect2">
234
<a name="g-datalist-init"></a><h3>g_datalist_init ()</h3>
235
<pre class="programlisting"><span class="returnvalue">void</span>
236
g_datalist_init (<em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> **datalist</code></em>);</pre>
237
<p>Resets the datalist to <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. It does not free any memory or call
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
238
any destroy functions.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
239
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
240
<a name="id-1.6.16.7.2.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
241
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
242
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
243
<col width="150px" class="parameters_name">
244
<col class="parameters_description">
245
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
246
</colgroup>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
247
<tbody><tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
248
<td class="parameter_name"><p>datalist</p></td>
249
<td class="parameter_description"><p>a pointer to a pointer to a datalist.</p></td>
250
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
251
</tr></tbody>
252
</table></div>
253
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
254
</div>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
255
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
256
<div class="refsect2">
1.2.41 by Sebastian Dröge
Import upstream version 2.17.0
257
<a name="g-datalist-id-set-data"></a><h3>g_datalist_id_set_data()</h3>
258
<pre class="programlisting">#define             g_datalist_id_set_data(dl, q, d)</pre>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
259
<p>Sets the data corresponding to the given <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> id. Any previous
1.8.2 by Sebastien Bacher
Import upstream version 2.23.3
260
data with the same key is removed, and its destroy function is
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
261
called.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
262
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
263
<a name="id-1.6.16.7.3.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
264
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
265
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
266
<col width="150px" class="parameters_name">
267
<col class="parameters_description">
268
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
269
</colgroup>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
270
<tbody>
271
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
272
<td class="parameter_name"><p>dl</p></td>
273
<td class="parameter_description"><p>a datalist.</p></td>
274
<td class="parameter_annotations"> </td>
275
</tr>
276
<tr>
277
<td class="parameter_name"><p>q</p></td>
278
<td class="parameter_description"><p>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> to identify the data element.</p></td>
279
<td class="parameter_annotations"> </td>
280
</tr>
281
<tr>
282
<td class="parameter_name"><p>d</p></td>
283
<td class="parameter_description"><p> the data element, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to remove any previous element
284
corresponding to <em class="parameter"><code>q</code></em>
285
. </p></td>
1.66.17 by Iain Lane
Import upstream version 2.41.3
286
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
287
</tr>
288
</tbody>
289
</table></div>
290
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
291
</div>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
292
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
293
<div class="refsect2">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
294
<a name="g-datalist-id-set-data-full"></a><h3>g_datalist_id_set_data_full ()</h3>
295
<pre class="programlisting"><span class="returnvalue">void</span>
296
g_datalist_id_set_data_full (<em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> **datalist</code></em>,
297
                             <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> key_id</code></em>,
298
                             <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
299
                             <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> destroy_func</code></em>);</pre>
300
<p>Sets the data corresponding to the given <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> id, and the
1.8.2 by Sebastien Bacher
Import upstream version 2.23.3
301
function to be called when the element is removed from the datalist.
302
Any previous data with the same key is removed, and its destroy
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
303
function is called.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
304
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
305
<a name="id-1.6.16.7.4.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
306
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
307
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
308
<col width="150px" class="parameters_name">
309
<col class="parameters_description">
310
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
311
</colgroup>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
312
<tbody>
313
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
314
<td class="parameter_name"><p>datalist</p></td>
315
<td class="parameter_description"><p>a datalist.</p></td>
316
<td class="parameter_annotations"> </td>
317
</tr>
318
<tr>
319
<td class="parameter_name"><p>key_id</p></td>
320
<td class="parameter_description"><p>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> to identify the data element.</p></td>
321
<td class="parameter_annotations"> </td>
322
</tr>
323
<tr>
324
<td class="parameter_name"><p>data</p></td>
325
<td class="parameter_description"><p> the data element or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to remove any previous element
326
corresponding to <em class="parameter"><code>key_id</code></em>
327
. </p></td>
1.66.17 by Iain Lane
Import upstream version 2.41.3
328
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
329
</tr>
330
<tr>
331
<td class="parameter_name"><p>destroy_func</p></td>
332
<td class="parameter_description"><p>the function to call when the data element is
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
333
removed. This function will be called with the data
334
element and can be used to free any memory allocated
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
335
for it. If <em class="parameter"><code>data</code></em>
336
is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then <em class="parameter"><code>destroy_func</code></em>
337
must
338
also be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.</p></td>
339
<td class="parameter_annotations"> </td>
1.3.1 by Gustavo Noronha Silva
Import upstream version 2.18.4
340
</tr>
341
</tbody>
342
</table></div>
343
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
344
</div>
1.3.1 by Gustavo Noronha Silva
Import upstream version 2.18.4
345
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
346
<div class="refsect2">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
347
<a name="g-datalist-id-get-data"></a><h3>g_datalist_id_get_data ()</h3>
348
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>
349
g_datalist_id_get_data (<em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> **datalist</code></em>,
350
                        <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> key_id</code></em>);</pre>
351
<p>Retrieves the data element corresponding to <em class="parameter"><code>key_id</code></em>
352
.</p>
353
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
354
<a name="id-1.6.16.7.5.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
355
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
356
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
357
<col width="150px" class="parameters_name">
358
<col class="parameters_description">
359
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
360
</colgroup>
1.3.1 by Gustavo Noronha Silva
Import upstream version 2.18.4
361
<tbody>
362
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
363
<td class="parameter_name"><p>datalist</p></td>
364
<td class="parameter_description"><p>a datalist.</p></td>
365
<td class="parameter_annotations"> </td>
366
</tr>
367
<tr>
368
<td class="parameter_name"><p>key_id</p></td>
369
<td class="parameter_description"><p>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> identifying a data element.</p></td>
370
<td class="parameter_annotations"> </td>
1.3.1 by Gustavo Noronha Silva
Import upstream version 2.18.4
371
</tr>
372
</tbody>
373
</table></div>
374
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
375
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
376
<a name="id-1.6.16.7.5.6"></a><h4>Returns</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
377
<p> the data element, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if it is not found.</p>
378
<p></p>
379
</div>
380
</div>
1.3.1 by Gustavo Noronha Silva
Import upstream version 2.18.4
381
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
382
<div class="refsect2">
1.2.41 by Sebastian Dröge
Import upstream version 2.17.0
383
<a name="g-datalist-id-remove-data"></a><h3>g_datalist_id_remove_data()</h3>
384
<pre class="programlisting">#define             g_datalist_id_remove_data(dl, q)</pre>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
385
<p>Removes an element, using its <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> identifier.</p>
386
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
387
<a name="id-1.6.16.7.6.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
388
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
389
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
390
<col width="150px" class="parameters_name">
391
<col class="parameters_description">
392
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
393
</colgroup>
1.3.1 by Gustavo Noronha Silva
Import upstream version 2.18.4
394
<tbody>
395
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
396
<td class="parameter_name"><p>dl</p></td>
397
<td class="parameter_description"><p>a datalist.</p></td>
398
<td class="parameter_annotations"> </td>
1.3.1 by Gustavo Noronha Silva
Import upstream version 2.18.4
399
</tr>
400
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
401
<td class="parameter_name"><p>q</p></td>
402
<td class="parameter_description"><p>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> identifying the data element.</p></td>
403
<td class="parameter_annotations"> </td>
1.3.1 by Gustavo Noronha Silva
Import upstream version 2.18.4
404
</tr>
405
</tbody>
406
</table></div>
407
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
408
</div>
1.3.1 by Gustavo Noronha Silva
Import upstream version 2.18.4
409
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
410
<div class="refsect2">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
411
<a name="g-datalist-id-remove-no-notify"></a><h3>g_datalist_id_remove_no_notify ()</h3>
412
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>
413
g_datalist_id_remove_no_notify (<em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> **datalist</code></em>,
414
                                <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> key_id</code></em>);</pre>
415
<p>Removes an element, without calling its destroy notification
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
416
function.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
417
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
418
<a name="id-1.6.16.7.7.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
419
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
420
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
421
<col width="150px" class="parameters_name">
422
<col class="parameters_description">
423
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
424
</colgroup>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
425
<tbody>
426
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
427
<td class="parameter_name"><p>datalist</p></td>
428
<td class="parameter_description"><p>a datalist.</p></td>
429
<td class="parameter_annotations"> </td>
430
</tr>
431
<tr>
432
<td class="parameter_name"><p>key_id</p></td>
433
<td class="parameter_description"><p>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> identifying a data element.</p></td>
434
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
435
</tr>
436
</tbody>
437
</table></div>
438
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
439
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
440
<a name="id-1.6.16.7.7.6"></a><h4>Returns</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
441
<p> the data previously stored at <em class="parameter"><code>key_id</code></em>
442
, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if none.</p>
443
<p></p>
444
</div>
445
</div>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
446
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
447
<div class="refsect2">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
448
<a name="GDuplicateFunc"></a><h3>GDuplicateFunc ()</h3>
449
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>
450
<span class="c_punctuation">(</span>*GDuplicateFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
451
                   <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
452
<p>The type of functions that are used to 'duplicate' an object.
1.64.1 by Martin Pitt
Import upstream version 2.33.12
453
What this means depends on the context, it could just be
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
454
incrementing the reference count, if <em class="parameter"><code>data</code></em>
455
 is a ref-counted
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
456
object.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
457
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
458
<a name="id-1.6.16.7.8.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
459
<div class="informaltable"><table width="100%" border="0">
1.63.17 by Emilio Pozuelo Monfort
Import upstream version 2.35.9
460
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
461
<col width="150px" class="parameters_name">
462
<col class="parameters_description">
463
<col width="200px" class="parameters_annotations">
1.63.17 by Emilio Pozuelo Monfort
Import upstream version 2.35.9
464
</colgroup>
1.64.1 by Martin Pitt
Import upstream version 2.33.12
465
<tbody>
466
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
467
<td class="parameter_name"><p>data</p></td>
468
<td class="parameter_description"><p>the data to duplicate</p></td>
469
<td class="parameter_annotations"> </td>
470
</tr>
471
<tr>
472
<td class="parameter_name"><p>user_data</p></td>
473
<td class="parameter_description"><p>user data that was specified in <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-dup-data" title="g_datalist_id_dup_data ()"><code class="function">g_datalist_id_dup_data()</code></a></p></td>
474
<td class="parameter_annotations"> </td>
1.64.1 by Martin Pitt
Import upstream version 2.33.12
475
</tr>
476
</tbody>
477
</table></div>
478
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
479
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
480
<a name="id-1.6.16.7.8.6"></a><h4>Returns</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
481
<p> a duplicate of data</p>
482
<p></p>
483
</div>
484
</div>
1.64.1 by Martin Pitt
Import upstream version 2.33.12
485
<hr>
486
<div class="refsect2">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
487
<a name="g-datalist-id-dup-data"></a><h3>g_datalist_id_dup_data ()</h3>
488
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>
489
g_datalist_id_dup_data (<em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> **datalist</code></em>,
490
                        <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> key_id</code></em>,
491
                        <em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GDuplicateFunc" title="GDuplicateFunc ()"><span class="type">GDuplicateFunc</span></a> dup_func</code></em>,
492
                        <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
493
<p>This is a variant of <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-get-data" title="g_datalist_id_get_data ()"><code class="function">g_datalist_id_get_data()</code></a> which
494
returns a 'duplicate' of the value. <em class="parameter"><code>dup_func</code></em>
495
 defines the
1.64.1 by Martin Pitt
Import upstream version 2.33.12
496
meaning of 'duplicate' in this context, it could e.g.
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
497
take a reference on a ref-counted object.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
498
<p>If the <em class="parameter"><code>key_id</code></em>
499
 is not set in the datalist then <em class="parameter"><code>dup_func</code></em>
500
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
501
will be called with a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> argument.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
502
<p>Note that <em class="parameter"><code>dup_func</code></em>
503
 is called while the datalist is locked, so it
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
504
is not allowed to read or modify the datalist.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
505
<p>This function can be useful to avoid races when multiple
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
506
threads are using the same datalist and the same key.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
507
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
508
<a name="id-1.6.16.7.9.8"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
509
<div class="informaltable"><table width="100%" border="0">
1.63.17 by Emilio Pozuelo Monfort
Import upstream version 2.35.9
510
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
511
<col width="150px" class="parameters_name">
512
<col class="parameters_description">
513
<col width="200px" class="parameters_annotations">
1.63.17 by Emilio Pozuelo Monfort
Import upstream version 2.35.9
514
</colgroup>
1.64.1 by Martin Pitt
Import upstream version 2.33.12
515
<tbody>
516
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
517
<td class="parameter_name"><p>datalist</p></td>
518
<td class="parameter_description"><p>location of a datalist</p></td>
519
<td class="parameter_annotations"> </td>
520
</tr>
521
<tr>
522
<td class="parameter_name"><p>key_id</p></td>
523
<td class="parameter_description"><p>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> identifying a data element</p></td>
524
<td class="parameter_annotations"> </td>
525
</tr>
526
<tr>
527
<td class="parameter_name"><p>dup_func</p></td>
528
<td class="parameter_description"><p> function to duplicate the old value. </p></td>
1.66.17 by Iain Lane
Import upstream version 2.41.3
529
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
530
</tr>
531
<tr>
532
<td class="parameter_name"><p>user_data</p></td>
533
<td class="parameter_description"><p> passed as user_data to <em class="parameter"><code>dup_func</code></em>
534
. </p></td>
1.66.17 by Iain Lane
Import upstream version 2.41.3
535
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1.64.1 by Martin Pitt
Import upstream version 2.33.12
536
</tr>
537
</tbody>
538
</table></div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
539
</div>
540
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
541
<a name="id-1.6.16.7.9.9"></a><h4>Returns</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
542
<p> the result of calling <em class="parameter"><code>dup_func</code></em>
543
on the value
544
associated with <em class="parameter"><code>key_id</code></em>
545
in <em class="parameter"><code>datalist</code></em>
546
, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if not set.
547
If <em class="parameter"><code>dup_func</code></em>
548
is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, the value is returned unmodified.</p>
549
<p></p>
550
</div>
1.64.1 by Martin Pitt
Import upstream version 2.33.12
551
<p class="since">Since 2.34</p>
552
</div>
553
<hr>
554
<div class="refsect2">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
555
<a name="g-datalist-id-replace-data"></a><h3>g_datalist_id_replace_data ()</h3>
556
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>
557
g_datalist_id_replace_data (<em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> **datalist</code></em>,
558
                            <em class="parameter"><code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> key_id</code></em>,
559
                            <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> oldval</code></em>,
560
                            <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> newval</code></em>,
561
                            <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
562
                            <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> *old_destroy</code></em>);</pre>
563
<p>Compares the member that is associated with <em class="parameter"><code>key_id</code></em>
564
 in
565
<em class="parameter"><code>datalist</code></em>
566
 to <em class="parameter"><code>oldval</code></em>
567
, and if they are the same, replace
568
<em class="parameter"><code>oldval</code></em>
569
 with <em class="parameter"><code>newval</code></em>
570
.</p>
571
<p>This is like a typical atomic compare-and-exchange
572
operation, for a member of <em class="parameter"><code>datalist</code></em>
573
.</p>
574
<p>If the previous value was replaced then ownership of the
575
old value (<em class="parameter"><code>oldval</code></em>
576
) is passed to the caller, including
577
the registred destroy notify for it (passed out in <em class="parameter"><code>old_destroy</code></em>
578
).
1.64.1 by Martin Pitt
Import upstream version 2.33.12
579
Its up to the caller to free this as he wishes, which may
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
580
or may not include using <em class="parameter"><code>old_destroy</code></em>
581
 as sometimes replacement
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
582
should not destroy the object in the normal way.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
583
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
584
<a name="id-1.6.16.7.10.7"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
585
<div class="informaltable"><table width="100%" border="0">
1.63.17 by Emilio Pozuelo Monfort
Import upstream version 2.35.9
586
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
587
<col width="150px" class="parameters_name">
588
<col class="parameters_description">
589
<col width="200px" class="parameters_annotations">
1.63.17 by Emilio Pozuelo Monfort
Import upstream version 2.35.9
590
</colgroup>
1.64.1 by Martin Pitt
Import upstream version 2.33.12
591
<tbody>
592
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
593
<td class="parameter_name"><p>datalist</p></td>
594
<td class="parameter_description"><p>location of a datalist</p></td>
595
<td class="parameter_annotations"> </td>
596
</tr>
597
<tr>
598
<td class="parameter_name"><p>key_id</p></td>
599
<td class="parameter_description"><p>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> identifying a data element</p></td>
600
<td class="parameter_annotations"> </td>
601
</tr>
602
<tr>
603
<td class="parameter_name"><p>oldval</p></td>
604
<td class="parameter_description"><p> the old value to compare against. </p></td>
1.66.17 by Iain Lane
Import upstream version 2.41.3
605
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
606
</tr>
607
<tr>
608
<td class="parameter_name"><p>newval</p></td>
609
<td class="parameter_description"><p> the new value to replace it with. </p></td>
1.66.17 by Iain Lane
Import upstream version 2.41.3
610
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
611
</tr>
612
<tr>
613
<td class="parameter_name"><p>destroy</p></td>
614
<td class="parameter_description"><p> destroy notify for the new value. </p></td>
1.66.17 by Iain Lane
Import upstream version 2.41.3
615
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
616
</tr>
617
<tr>
618
<td class="parameter_name"><p>old_destroy</p></td>
619
<td class="parameter_description"><p> destroy notify for the existing value. </p></td>
1.66.17 by Iain Lane
Import upstream version 2.41.3
620
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1.64.1 by Martin Pitt
Import upstream version 2.33.12
621
</tr>
622
</tbody>
623
</table></div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
624
</div>
1.66.16 by Iain Lane
Import upstream version 2.41.2
625
<div class="refsect3">
626
<a name="id-1.6.16.7.10.8"></a><h4>Returns</h4>
627
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the existing value for <em class="parameter"><code>key_id</code></em>
628
was replaced
629
by <em class="parameter"><code>newval</code></em>
630
, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise.</p>
631
<p></p>
632
</div>
1.64.1 by Martin Pitt
Import upstream version 2.33.12
633
<p class="since">Since 2.34</p>
634
</div>
635
<hr>
636
<div class="refsect2">
1.2.41 by Sebastian Dröge
Import upstream version 2.17.0
637
<a name="g-datalist-set-data"></a><h3>g_datalist_set_data()</h3>
638
<pre class="programlisting">#define             g_datalist_set_data(dl, k, d)</pre>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
639
<p>Sets the data element corresponding to the given string identifier.</p>
640
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
641
<a name="id-1.6.16.7.11.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
642
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
643
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
644
<col width="150px" class="parameters_name">
645
<col class="parameters_description">
646
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
647
</colgroup>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
648
<tbody>
649
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
650
<td class="parameter_name"><p>dl</p></td>
651
<td class="parameter_description"><p>a datalist.</p></td>
652
<td class="parameter_annotations"> </td>
653
</tr>
654
<tr>
655
<td class="parameter_name"><p>k</p></td>
656
<td class="parameter_description"><p>the string to identify the data element.</p></td>
657
<td class="parameter_annotations"> </td>
658
</tr>
659
<tr>
660
<td class="parameter_name"><p>d</p></td>
661
<td class="parameter_description"><p> the data element, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to remove any previous element
662
corresponding to <em class="parameter"><code>k</code></em>
663
. </p></td>
1.66.17 by Iain Lane
Import upstream version 2.41.3
664
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
665
</tr>
666
</tbody>
667
</table></div>
668
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
669
</div>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
670
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
671
<div class="refsect2">
1.2.41 by Sebastian Dröge
Import upstream version 2.17.0
672
<a name="g-datalist-set-data-full"></a><h3>g_datalist_set_data_full()</h3>
673
<pre class="programlisting">#define             g_datalist_set_data_full(dl, k, d, f)</pre>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
674
<p>Sets the data element corresponding to the given string identifier,
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
675
and the function to be called when the data element is removed.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
676
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
677
<a name="id-1.6.16.7.12.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
678
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
679
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
680
<col width="150px" class="parameters_name">
681
<col class="parameters_description">
682
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
683
</colgroup>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
684
<tbody>
685
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
686
<td class="parameter_name"><p>dl</p></td>
687
<td class="parameter_description"><p>a datalist.</p></td>
688
<td class="parameter_annotations"> </td>
689
</tr>
690
<tr>
691
<td class="parameter_name"><p>k</p></td>
692
<td class="parameter_description"><p>the string to identify the data element.</p></td>
693
<td class="parameter_annotations"> </td>
694
</tr>
695
<tr>
696
<td class="parameter_name"><p>d</p></td>
697
<td class="parameter_description"><p> the data element, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to remove any previous element
698
corresponding to <em class="parameter"><code>k</code></em>
699
. </p></td>
1.66.17 by Iain Lane
Import upstream version 2.41.3
700
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
701
</tr>
702
<tr>
703
<td class="parameter_name"><p>f</p></td>
704
<td class="parameter_description"><p>the function to call when the data element is removed. This
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
705
function will be called with the data element and can be used to
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
706
free any memory allocated for it. If <em class="parameter"><code>d</code></em>
707
is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then <em class="parameter"><code>f</code></em>
708
must
709
also be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.</p></td>
710
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
711
</tr>
712
</tbody>
713
</table></div>
714
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
715
</div>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
716
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
717
<div class="refsect2">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
718
<a name="g-datalist-get-data"></a><h3>g_datalist_get_data ()</h3>
719
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>
720
g_datalist_get_data (<em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> **datalist</code></em>,
721
                     <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
722
<p>Gets a data element, using its string identifier. This is slower than
723
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-get-data" title="g_datalist_id_get_data ()"><code class="function">g_datalist_id_get_data()</code></a> because it compares strings.</p>
724
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
725
<a name="id-1.6.16.7.13.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
726
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
727
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
728
<col width="150px" class="parameters_name">
729
<col class="parameters_description">
730
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
731
</colgroup>
1.62.9 by Sebastien Bacher
Import upstream version 2.29.16
732
<tbody>
733
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
734
<td class="parameter_name"><p>datalist</p></td>
735
<td class="parameter_description"><p>a datalist.</p></td>
736
<td class="parameter_annotations"> </td>
737
</tr>
738
<tr>
739
<td class="parameter_name"><p>key</p></td>
740
<td class="parameter_description"><p>the string identifying a data element.</p></td>
741
<td class="parameter_annotations"> </td>
1.62.9 by Sebastien Bacher
Import upstream version 2.29.16
742
</tr>
743
</tbody>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
744
</table></div>
745
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
746
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
747
<a name="id-1.6.16.7.13.6"></a><h4>Returns</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
748
<p> the data element, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if it is not found.</p>
749
<p></p>
750
</div>
751
</div>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
752
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
753
<div class="refsect2">
1.2.41 by Sebastian Dröge
Import upstream version 2.17.0
754
<a name="g-datalist-remove-data"></a><h3>g_datalist_remove_data()</h3>
755
<pre class="programlisting">#define             g_datalist_remove_data(dl, k)</pre>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
756
<p>Removes an element using its string identifier. The data element's
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
757
destroy function is called if it has been set.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
758
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
759
<a name="id-1.6.16.7.14.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
760
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
761
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
762
<col width="150px" class="parameters_name">
763
<col class="parameters_description">
764
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
765
</colgroup>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
766
<tbody>
767
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
768
<td class="parameter_name"><p>dl</p></td>
769
<td class="parameter_description"><p>a datalist.</p></td>
770
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
771
</tr>
772
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
773
<td class="parameter_name"><p>k</p></td>
774
<td class="parameter_description"><p>the string identifying the data element.</p></td>
775
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
776
</tr>
777
</tbody>
778
</table></div>
779
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
780
</div>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
781
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
782
<div class="refsect2">
1.2.41 by Sebastian Dröge
Import upstream version 2.17.0
783
<a name="g-datalist-remove-no-notify"></a><h3>g_datalist_remove_no_notify()</h3>
784
<pre class="programlisting">#define             g_datalist_remove_no_notify(dl, k)</pre>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
785
<p>Removes an element, without calling its destroy notifier.</p>
786
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
787
<a name="id-1.6.16.7.15.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
788
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
789
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
790
<col width="150px" class="parameters_name">
791
<col class="parameters_description">
792
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
793
</colgroup>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
794
<tbody>
795
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
796
<td class="parameter_name"><p>dl</p></td>
797
<td class="parameter_description"><p>a datalist.</p></td>
798
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
799
</tr>
800
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
801
<td class="parameter_name"><p>k</p></td>
802
<td class="parameter_description"><p>the string identifying the data element.</p></td>
803
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
804
</tr>
805
</tbody>
806
</table></div>
807
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
808
</div>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
809
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
810
<div class="refsect2">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
811
<a name="g-datalist-foreach"></a><h3>g_datalist_foreach ()</h3>
812
<pre class="programlisting"><span class="returnvalue">void</span>
813
g_datalist_foreach (<em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> **datalist</code></em>,
814
                    <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDataForeachFunc" title="GDataForeachFunc ()"><span class="type">GDataForeachFunc</span></a> func</code></em>,
815
                    <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
816
<p>Calls the given function for each data element of the datalist. The
1.8.2 by Sebastien Bacher
Import upstream version 2.23.3
817
function is called with each data element's <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> id and data,
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
818
together with the given <em class="parameter"><code>user_data</code></em>
819
 parameter. Note that this
820
function is NOT thread-safe. So unless <em class="parameter"><code>datalist</code></em>
821
 can be protected
1.8.2 by Sebastien Bacher
Import upstream version 2.23.3
822
from any modifications during invocation of this function, it should
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
823
not be called.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
824
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
825
<a name="id-1.6.16.7.16.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
826
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
827
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
828
<col width="150px" class="parameters_name">
829
<col class="parameters_description">
830
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
831
</colgroup>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
832
<tbody>
833
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
834
<td class="parameter_name"><p>datalist</p></td>
835
<td class="parameter_description"><p>a datalist.</p></td>
836
<td class="parameter_annotations"> </td>
837
</tr>
838
<tr>
839
<td class="parameter_name"><p>func</p></td>
840
<td class="parameter_description"><p>the function to call for each data element.</p></td>
841
<td class="parameter_annotations"> </td>
842
</tr>
843
<tr>
844
<td class="parameter_name"><p>user_data</p></td>
845
<td class="parameter_description"><p>user data to pass to the function.</p></td>
846
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
847
</tr>
848
</tbody>
849
</table></div>
850
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
851
</div>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
852
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
853
<div class="refsect2">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
854
<a name="g-datalist-clear"></a><h3>g_datalist_clear ()</h3>
855
<pre class="programlisting"><span class="returnvalue">void</span>
856
g_datalist_clear (<em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> **datalist</code></em>);</pre>
857
<p>Frees all the data elements of the datalist.
1.62.6 by Sebastien Bacher
Import upstream version 2.29.8
858
The data elements' destroy functions are called
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
859
if they have been set.</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
860
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
861
<a name="id-1.6.16.7.17.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
862
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
863
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
864
<col width="150px" class="parameters_name">
865
<col class="parameters_description">
866
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
867
</colgroup>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
868
<tbody><tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
869
<td class="parameter_name"><p>datalist</p></td>
870
<td class="parameter_description"><p>a datalist.</p></td>
871
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
872
</tr></tbody>
873
</table></div>
874
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
875
</div>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
876
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
877
<div class="refsect2">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
878
<a name="g-datalist-set-flags"></a><h3>g_datalist_set_flags ()</h3>
879
<pre class="programlisting"><span class="returnvalue">void</span>
880
g_datalist_set_flags (<em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> **datalist</code></em>,
881
                      <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> flags</code></em>);</pre>
882
<p>Turns on flag values for a data list. This function is used
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
883
to keep a small number of boolean flags in an object with
884
a data list without using any additional space. It is
885
not generally useful except in circumstances where space
1.66.20 by Iain Lane
Import upstream version 2.42.0
886
is very tight. (It is used in the base <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type, for
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
887
example.)</p>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
888
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
889
<a name="id-1.6.16.7.18.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
890
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
891
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
892
<col width="150px" class="parameters_name">
893
<col class="parameters_description">
894
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
895
</colgroup>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
896
<tbody>
897
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
898
<td class="parameter_name"><p>datalist</p></td>
899
<td class="parameter_description"><p>pointer to the location that holds a list</p></td>
900
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
901
</tr>
902
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
903
<td class="parameter_name"><p>flags</p></td>
904
<td class="parameter_description"><p>the flags to turn on. The values of the flags are
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
905
restricted by <a class="link" href="glib-Keyed-Data-Lists.html#G-DATALIST-FLAGS-MASK:CAPS" title="G_DATALIST_FLAGS_MASK"><code class="literal">G_DATALIST_FLAGS_MASK</code></a> (currently
906
3; giving two possible boolean flags).
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
907
A value for <em class="parameter"><code>flags</code></em>
908
that doesn't fit within the mask is
909
an error.</p></td>
910
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
911
</tr>
912
</tbody>
913
</table></div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
914
</div>
1.2.50 by Sebastien Bacher
Import upstream version 2.19.2
915
<p class="since">Since 2.8</p>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
916
</div>
917
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
918
<div class="refsect2">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
919
<a name="g-datalist-unset-flags"></a><h3>g_datalist_unset_flags ()</h3>
920
<pre class="programlisting"><span class="returnvalue">void</span>
921
g_datalist_unset_flags (<em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> **datalist</code></em>,
922
                        <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> flags</code></em>);</pre>
923
<p>Turns off flag values for a data list. See <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-unset-flags" title="g_datalist_unset_flags ()"><code class="function">g_datalist_unset_flags()</code></a></p>
924
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
925
<a name="id-1.6.16.7.19.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
926
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
927
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
928
<col width="150px" class="parameters_name">
929
<col class="parameters_description">
930
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
931
</colgroup>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
932
<tbody>
933
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
934
<td class="parameter_name"><p>datalist</p></td>
935
<td class="parameter_description"><p>pointer to the location that holds a list</p></td>
936
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
937
</tr>
938
<tr>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
939
<td class="parameter_name"><p>flags</p></td>
940
<td class="parameter_description"><p>the flags to turn off. The values of the flags are
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
941
restricted by <a class="link" href="glib-Keyed-Data-Lists.html#G-DATALIST-FLAGS-MASK:CAPS" title="G_DATALIST_FLAGS_MASK"><code class="literal">G_DATALIST_FLAGS_MASK</code></a> (currently
942
3: giving two possible boolean flags).
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
943
A value for <em class="parameter"><code>flags</code></em>
944
that doesn't fit within the mask is
945
an error.</p></td>
946
<td class="parameter_annotations"> </td>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
947
</tr>
948
</tbody>
949
</table></div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
950
</div>
1.2.50 by Sebastien Bacher
Import upstream version 2.19.2
951
<p class="since">Since 2.8</p>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
952
</div>
953
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
954
<div class="refsect2">
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
955
<a name="g-datalist-get-flags"></a><h3>g_datalist_get_flags ()</h3>
956
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>
957
g_datalist_get_flags (<em class="parameter"><code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> **datalist</code></em>);</pre>
958
<p>Gets flags values packed in together with the datalist.
959
See <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-set-flags" title="g_datalist_set_flags ()"><code class="function">g_datalist_set_flags()</code></a>.</p>
960
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
961
<a name="id-1.6.16.7.20.5"></a><h4>Parameters</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
962
<div class="informaltable"><table width="100%" border="0">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
963
<colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
964
<col width="150px" class="parameters_name">
965
<col class="parameters_description">
966
<col width="200px" class="parameters_annotations">
1.27.13 by Josselin Mouette
Import upstream version 2.33.12+really2.32.4
967
</colgroup>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
968
<tbody><tr>
969
<td class="parameter_name"><p>datalist</p></td>
970
<td class="parameter_description"><p>pointer to the location that holds a list</p></td>
971
<td class="parameter_annotations"> </td>
972
</tr></tbody>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
973
</table></div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
974
</div>
975
<div class="refsect3">
1.66.16 by Iain Lane
Import upstream version 2.41.2
976
<a name="id-1.6.16.7.20.6"></a><h4>Returns</h4>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
977
<p> the flags of the datalist</p>
978
<p></p>
979
</div>
1.2.50 by Sebastien Bacher
Import upstream version 2.19.2
980
<p class="since">Since 2.8</p>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
981
</div>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
982
</div>
983
<div class="refsect1">
984
<a name="glib-Keyed-Data-Lists.other_details"></a><h2>Types and Values</h2>
985
<div class="refsect2">
986
<a name="GData"></a><h3>GData</h3>
987
<pre class="programlisting">typedef struct _GData GData;</pre>
988
<p>The <a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData"><span class="type">GData</span></a> struct is an opaque data structure to represent a
989
<a class="link" href="glib-Keyed-Data-Lists.html" title="Keyed Data Lists">Keyed Data List</a>. It should only be
990
accessed via the following functions.</p>
991
</div>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
992
<hr>
1.25.12 by Sebastien Bacher
Import upstream version 2.27.93
993
<div class="refsect2">
1.8.5 by Sebastian Dröge
Import upstream version 2.23.6
994
<a name="G-DATALIST-FLAGS-MASK:CAPS"></a><h3>G_DATALIST_FLAGS_MASK</h3>
1.8.4 by Sebastian Dröge
Import upstream version 2.23.5
995
<pre class="programlisting">#define G_DATALIST_FLAGS_MASK 0x3
996
</pre>
1.66.10 by Andreas Henriksson
Import upstream version 2.39.90
997
<p>A bitmask that restricts the possible flags passed to
998
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-set-flags" title="g_datalist_set_flags ()"><code class="function">g_datalist_set_flags()</code></a>. Passing a flags value where
1.66.9 by Emilio Pozuelo Monfort
Import upstream version 2.39.4
999
flags &amp; ~G_DATALIST_FLAGS_MASK != 0 is an error.</p>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
1000
</div>
1001
</div>
1.2.41 by Sebastian Dröge
Import upstream version 2.17.0
1002
</div>
1003
<div class="footer">
1.2.30 by Loic Minier
Import upstream version 2.14.4
1004
<hr>
1.66.17 by Iain Lane
Import upstream version 2.41.3
1005
          Generated by GTK-Doc V1.21.1</div>
1.2.21 by Sebastien Bacher
Import upstream version 2.12.12
1006
</body>
1.8.5 by Sebastian Dröge
Import upstream version 2.23.6
1007
</html>