← Back to branch summary

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