Update to upstream 1.0.1
[profile/ivi/gsignond.git] / docs / html / gsignond-GSignondDictionary.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>gsignond API Reference Manual: GSignondDictionary</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7 <link rel="home" href="index.html" title="gsignond API Reference Manual">
8 <link rel="up" href="ch04.html" title="GSignond API for writing GLib-based authentication plugins">
9 <link rel="prev" href="GSignondPlugin.html" title="GSignondPlugin">
10 <link rel="next" href="gsignond-GSignondSessionData.html" title="GSignondSessionData">
11 <meta name="generator" content="GTK-Doc V1.20 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16 <td width="100%" align="left" class="shortcuts">
17 <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 
18                   <a href="#gsignond-GSignondDictionary.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19                   <a href="#gsignond-GSignondDictionary.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
20 </td>
21 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22 <td><a accesskey="u" href="ch04.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23 <td><a accesskey="p" href="GSignondPlugin.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24 <td><a accesskey="n" href="gsignond-GSignondSessionData.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
25 </tr></table>
26 <div class="refentry">
27 <a name="gsignond-GSignondDictionary"></a><div class="titlepage"></div>
28 <div class="refnamediv"><table width="100%"><tr>
29 <td valign="top">
30 <h2><span class="refentrytitle"><a name="gsignond-GSignondDictionary.top_of_page"></a>GSignondDictionary</span></h2>
31 <p>GSignondDictionary — a dictionary container holding string keys and variant values</p>
32 </td>
33 <td class="gallery_image" valign="top" align="right"></td>
34 </tr></table></div>
35 <div class="refsect1">
36 <a name="gsignond-GSignondDictionary.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 <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="returnvalue">GSignondDictionary</span></a> *
46 </td>
47 <td class="function_name">
48 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-new" title="gsignond_dictionary_new ()">gsignond_dictionary_new</a> <span class="c_punctuation">()</span>
49 </td>
50 </tr>
51 <tr>
52 <td class="function_type">
53 <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="returnvalue">GSignondDictionary</span></a> *
54 </td>
55 <td class="function_name">
56 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-ref" title="gsignond_dictionary_ref ()">gsignond_dictionary_ref</a> <span class="c_punctuation">()</span>
57 </td>
58 </tr>
59 <tr>
60 <td class="function_type">
61 <span class="returnvalue">void</span>
62 </td>
63 <td class="function_name">
64 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-unref" title="gsignond_dictionary_unref ()">gsignond_dictionary_unref</a> <span class="c_punctuation">()</span>
65 </td>
66 </tr>
67 <tr>
68 <td class="function_type">
69 <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="returnvalue">GSignondDictionary</span></a> *
70 </td>
71 <td class="function_name">
72 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-copy" title="gsignond_dictionary_copy ()">gsignond_dictionary_copy</a> <span class="c_punctuation">()</span>
73 </td>
74 </tr>
75 <tr>
76 <td class="function_type">
77 <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="returnvalue">GSignondDictionary</span></a> *
78 </td>
79 <td class="function_name">
80 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-new-from-variant" title="gsignond_dictionary_new_from_variant ()">gsignond_dictionary_new_from_variant</a> <span class="c_punctuation">()</span>
81 </td>
82 </tr>
83 <tr>
84 <td class="function_type">
85 <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
86 </td>
87 <td class="function_name">
88 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-to-variant" title="gsignond_dictionary_to_variant ()">gsignond_dictionary_to_variant</a> <span class="c_punctuation">()</span>
89 </td>
90 </tr>
91 <tr>
92 <td class="function_type">
93 <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariantBuilder"><span class="returnvalue">GVariantBuilder</span></a> *
94 </td>
95 <td class="function_name">
96 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-to-variant-builder" title="gsignond_dictionary_to_variant_builder ()">gsignond_dictionary_to_variant_builder</a> <span class="c_punctuation">()</span>
97 </td>
98 </tr>
99 <tr>
100 <td class="function_type">
101 <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
102 </td>
103 <td class="function_name">
104 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-get" title="gsignond_dictionary_get ()">gsignond_dictionary_get</a> <span class="c_punctuation">()</span>
105 </td>
106 </tr>
107 <tr>
108 <td class="function_type">
109 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
110 </td>
111 <td class="function_name">
112 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-set" title="gsignond_dictionary_set ()">gsignond_dictionary_set</a> <span class="c_punctuation">()</span>
113 </td>
114 </tr>
115 <tr>
116 <td class="function_type">
117 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
118 </td>
119 <td class="function_name">
120 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-get-boolean" title="gsignond_dictionary_get_boolean ()">gsignond_dictionary_get_boolean</a> <span class="c_punctuation">()</span>
121 </td>
122 </tr>
123 <tr>
124 <td class="function_type">
125 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
126 </td>
127 <td class="function_name">
128 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-set-boolean" title="gsignond_dictionary_set_boolean ()">gsignond_dictionary_set_boolean</a> <span class="c_punctuation">()</span>
129 </td>
130 </tr>
131 <tr>
132 <td class="function_type">
133 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
134 </td>
135 <td class="function_name">
136 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-get-int32" title="gsignond_dictionary_get_int32 ()">gsignond_dictionary_get_int32</a> <span class="c_punctuation">()</span>
137 </td>
138 </tr>
139 <tr>
140 <td class="function_type">
141 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
142 </td>
143 <td class="function_name">
144 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-set-int32" title="gsignond_dictionary_set_int32 ()">gsignond_dictionary_set_int32</a> <span class="c_punctuation">()</span>
145 </td>
146 </tr>
147 <tr>
148 <td class="function_type">
149 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
150 </td>
151 <td class="function_name">
152 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-get-uint32" title="gsignond_dictionary_get_uint32 ()">gsignond_dictionary_get_uint32</a> <span class="c_punctuation">()</span>
153 </td>
154 </tr>
155 <tr>
156 <td class="function_type">
157 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
158 </td>
159 <td class="function_name">
160 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-set-uint32" title="gsignond_dictionary_set_uint32 ()">gsignond_dictionary_set_uint32</a> <span class="c_punctuation">()</span>
161 </td>
162 </tr>
163 <tr>
164 <td class="function_type">
165 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
166 </td>
167 <td class="function_name">
168 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-get-int64" title="gsignond_dictionary_get_int64 ()">gsignond_dictionary_get_int64</a> <span class="c_punctuation">()</span>
169 </td>
170 </tr>
171 <tr>
172 <td class="function_type">
173 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
174 </td>
175 <td class="function_name">
176 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-set-int64" title="gsignond_dictionary_set_int64 ()">gsignond_dictionary_set_int64</a> <span class="c_punctuation">()</span>
177 </td>
178 </tr>
179 <tr>
180 <td class="function_type">
181 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
182 </td>
183 <td class="function_name">
184 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-get-uint64" title="gsignond_dictionary_get_uint64 ()">gsignond_dictionary_get_uint64</a> <span class="c_punctuation">()</span>
185 </td>
186 </tr>
187 <tr>
188 <td class="function_type">
189 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
190 </td>
191 <td class="function_name">
192 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-set-uint64" title="gsignond_dictionary_set_uint64 ()">gsignond_dictionary_set_uint64</a> <span class="c_punctuation">()</span>
193 </td>
194 </tr>
195 <tr>
196 <td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
197 </td>
198 <td class="function_name">
199 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-get-string" title="gsignond_dictionary_get_string ()">gsignond_dictionary_get_string</a> <span class="c_punctuation">()</span>
200 </td>
201 </tr>
202 <tr>
203 <td class="function_type">
204 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
205 </td>
206 <td class="function_name">
207 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-set-string" title="gsignond_dictionary_set_string ()">gsignond_dictionary_set_string</a> <span class="c_punctuation">()</span>
208 </td>
209 </tr>
210 <tr>
211 <td class="function_type">
212 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
213 </td>
214 <td class="function_name">
215 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-remove" title="gsignond_dictionary_remove ()">gsignond_dictionary_remove</a> <span class="c_punctuation">()</span>
216 </td>
217 </tr>
218 <tr>
219 <td class="function_type">
220 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
221 </td>
222 <td class="function_name">
223 <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-contains" title="gsignond_dictionary_contains ()">gsignond_dictionary_contains</a> <span class="c_punctuation">()</span>
224 </td>
225 </tr>
226 </tbody>
227 </table></div>
228 </div>
229 <div class="refsect1">
230 <a name="gsignond-GSignondDictionary.object-hierarchy"></a><h2>Object Hierarchy</h2>
231 <pre class="screen">
232 </pre>
233 </div>
234 <div class="refsect1">
235 <a name="gsignond-GSignondDictionary.includes"></a><h2>Includes</h2>
236 <pre class="synopsis">#include &lt;gsignond/gsignond-dictionary.h&gt;
237 </pre>
238 </div>
239 <div class="refsect1">
240 <a name="gsignond-GSignondDictionary.description"></a><h2>Description</h2>
241 <p>A <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> is a dictionary data structure that maps string keys to <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> values.
242 It's used in multiple places in gsignond and its public API to pass key-value
243 data sets.</p>
244 <div class="informalexample">
245   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
246     <tbody>
247       <tr>
248         <td class="listing_lines" align="right"><pre>1
249 2
250 3
251 4
252 5
253 6
254 7</pre></td>
255         <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gsignond-GSignondDictionary.html#gsignond-dictionary-set-string">gsignond_dictionary_set_string</a></span><span class="gtkdoc opt">(</span>dict<span class="gtkdoc opt">,</span> <span class="string">&quot;name&quot;</span><span class="gtkdoc opt">,</span> <span class="string">&quot;John Smith&quot;</span><span class="gtkdoc opt">);</span>
256 <span class="function"><a href="gsignond-GSignondDictionary.html#gsignond-dictionary-set-uint32">gsignond_dictionary_set_uint32</a></span><span class="gtkdoc opt">(</span>dict<span class="gtkdoc opt">,</span> <span class="string">&quot;age&quot;</span><span class="gtkdoc opt">,</span> <span class="number">32</span><span class="gtkdoc opt">);</span>
257
258 guint32 age<span class="gtkdoc opt">;</span>
259 gboolean success <span class="gtkdoc opt">=</span> <span class="function"><a href="gsignond-GSignondDictionary.html#gsignond-dictionary-get-uint32">gsignond_dictionary_get_uint32</a></span><span class="gtkdoc opt">(</span>dict<span class="gtkdoc opt">,</span> <span class="string">&quot;age&quot;</span><span class="gtkdoc opt">, &amp;</span>age<span class="gtkdoc opt">);</span>
260 <span class="gtkdoc kwb">const</span> gchar<span class="gtkdoc opt">*</span> name <span class="gtkdoc opt">=</span> <span class="function"><a href="gsignond-GSignondDictionary.html#gsignond-dictionary-get-string">gsignond_dictionary_get_string</a></span><span class="gtkdoc opt">(</span>dict<span class="gtkdoc opt">,</span> <span class="string">&quot;name&quot;</span><span class="gtkdoc opt">);</span>
261 <span class="function"><a href="gsignond-GSignondDictionary.html#gsignond-dictionary-unref">gsignond_dictionary_unref</a></span><span class="gtkdoc opt">(</span>dict<span class="gtkdoc opt">);</span></pre></td>
262       </tr>
263     </tbody>
264   </table>
265 </div>
266
267 <p></p>
268 </div>
269 <div class="refsect1">
270 <a name="gsignond-GSignondDictionary.functions_details"></a><h2>Functions</h2>
271 <div class="refsect2">
272 <a name="gsignond-dictionary-new"></a><h3>gsignond_dictionary_new ()</h3>
273 <pre class="programlisting"><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="returnvalue">GSignondDictionary</span></a> *
274 gsignond_dictionary_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
275 <p>Creates a new instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a>.</p>
276 <div class="refsect3">
277 <a name="id-1.5.3.7.2.5"></a><h4>Returns</h4>
278 <p> <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> object if successful,
279 NULL otherwise. </p>
280 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
281 </div>
282 </div>
283 <hr>
284 <div class="refsect2">
285 <a name="gsignond-dictionary-ref"></a><h3>gsignond_dictionary_ref ()</h3>
286 <pre class="programlisting"><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="returnvalue">GSignondDictionary</span></a> *
287 gsignond_dictionary_ref (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>);</pre>
288 <p>Increments the reference count of the dictionary structure.</p>
289 <div class="refsect3">
290 <a name="id-1.5.3.7.3.5"></a><h4>Parameters</h4>
291 <div class="informaltable"><table width="100%" border="0">
292 <colgroup>
293 <col width="150px" class="parameters_name">
294 <col class="parameters_description">
295 <col width="200px" class="parameters_annotations">
296 </colgroup>
297 <tbody><tr>
298 <td class="parameter_name"><p>dict</p></td>
299 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
300 <td class="parameter_annotations"> </td>
301 </tr></tbody>
302 </table></div>
303 </div>
304 <div class="refsect3">
305 <a name="id-1.5.3.7.3.6"></a><h4>Returns</h4>
306 <p> the pointer to the passed in <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p>
307 <p></p>
308 </div>
309 </div>
310 <hr>
311 <div class="refsect2">
312 <a name="gsignond-dictionary-unref"></a><h3>gsignond_dictionary_unref ()</h3>
313 <pre class="programlisting"><span class="returnvalue">void</span>
314 gsignond_dictionary_unref (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>);</pre>
315 <p>Decrements the reference count of the dictionary structure. If the reference
316 count reaches zero, the structure is deallocated and shouldn't be used.</p>
317 <div class="refsect3">
318 <a name="id-1.5.3.7.4.5"></a><h4>Parameters</h4>
319 <div class="informaltable"><table width="100%" border="0">
320 <colgroup>
321 <col width="150px" class="parameters_name">
322 <col class="parameters_description">
323 <col width="200px" class="parameters_annotations">
324 </colgroup>
325 <tbody><tr>
326 <td class="parameter_name"><p>dict</p></td>
327 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
328 <td class="parameter_annotations"> </td>
329 </tr></tbody>
330 </table></div>
331 </div>
332 </div>
333 <hr>
334 <div class="refsect2">
335 <a name="gsignond-dictionary-copy"></a><h3>gsignond_dictionary_copy ()</h3>
336 <pre class="programlisting"><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="returnvalue">GSignondDictionary</span></a> *
337 gsignond_dictionary_copy (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *other</code></em>);</pre>
338 <p>Creates a copy of the dictionary.</p>
339 <div class="refsect3">
340 <a name="id-1.5.3.7.5.5"></a><h4>Parameters</h4>
341 <div class="informaltable"><table width="100%" border="0">
342 <colgroup>
343 <col width="150px" class="parameters_name">
344 <col class="parameters_description">
345 <col width="200px" class="parameters_annotations">
346 </colgroup>
347 <tbody><tr>
348 <td class="parameter_name"><p>other</p></td>
349 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
350 <td class="parameter_annotations"> </td>
351 </tr></tbody>
352 </table></div>
353 </div>
354 <div class="refsect3">
355 <a name="id-1.5.3.7.5.6"></a><h4>Returns</h4>
356 <p> <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> object if the copy was successful,
357 NULL otherwise. </p>
358 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
359 </div>
360 </div>
361 <hr>
362 <div class="refsect2">
363 <a name="gsignond-dictionary-new-from-variant"></a><h3>gsignond_dictionary_new_from_variant ()</h3>
364 <pre class="programlisting"><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="returnvalue">GSignondDictionary</span></a> *
365 gsignond_dictionary_new_from_variant (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *variant</code></em>);</pre>
366 <p>Converts the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a>. This is useful for example if 
367 the dictionary needs to be deserialized, or if it's contained in another 
368 <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> and has been retrieved using <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-get" title="gsignond_dictionary_get ()"><code class="function">gsignond_dictionary_get()</code></a>.</p>
369 <div class="refsect3">
370 <a name="id-1.5.3.7.6.5"></a><h4>Parameters</h4>
371 <div class="informaltable"><table width="100%" border="0">
372 <colgroup>
373 <col width="150px" class="parameters_name">
374 <col class="parameters_description">
375 <col width="200px" class="parameters_annotations">
376 </colgroup>
377 <tbody><tr>
378 <td class="parameter_name"><p>variant</p></td>
379 <td class="parameter_description"><p>instance of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a></p></td>
380 <td class="parameter_annotations"> </td>
381 </tr></tbody>
382 </table></div>
383 </div>
384 <div class="refsect3">
385 <a name="id-1.5.3.7.6.6"></a><h4>Returns</h4>
386 <p> <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> if successful, NULL otherwise. </p>
387 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
388 </div>
389 </div>
390 <hr>
391 <div class="refsect2">
392 <a name="gsignond-dictionary-to-variant"></a><h3>gsignond_dictionary_to_variant ()</h3>
393 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
394 gsignond_dictionary_to_variant (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>);</pre>
395 <p>Converts the <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>. The result can be serialized
396 or put into another <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> using <a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-set" title="gsignond_dictionary_set ()"><code class="function">gsignond_dictionary_set()</code></a>.</p>
397 <div class="refsect3">
398 <a name="id-1.5.3.7.7.5"></a><h4>Parameters</h4>
399 <div class="informaltable"><table width="100%" border="0">
400 <colgroup>
401 <col width="150px" class="parameters_name">
402 <col class="parameters_description">
403 <col width="200px" class="parameters_annotations">
404 </colgroup>
405 <tbody><tr>
406 <td class="parameter_name"><p>dict</p></td>
407 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
408 <td class="parameter_annotations"> </td>
409 </tr></tbody>
410 </table></div>
411 </div>
412 <div class="refsect3">
413 <a name="id-1.5.3.7.7.6"></a><h4>Returns</h4>
414 <p> <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> object if successful, NULL otherwise. </p>
415 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
416 </div>
417 </div>
418 <hr>
419 <div class="refsect2">
420 <a name="gsignond-dictionary-to-variant-builder"></a><h3>gsignond_dictionary_to_variant_builder ()</h3>
421 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariantBuilder"><span class="returnvalue">GVariantBuilder</span></a> *
422 gsignond_dictionary_to_variant_builder
423                                (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>);</pre>
424 <p>Converts the <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariantBuilder"><span class="type">GVariantBuilder</span></a> of type 
425 G_VARIANT_TYPE_VARDICT.</p>
426 <p>Caller should use <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-builder-unref"><code class="function">g_variant_builder_unref()</code></a> on the return value when it is
427 no longer needed.</p>
428 <div class="refsect3">
429 <a name="id-1.5.3.7.8.6"></a><h4>Parameters</h4>
430 <div class="informaltable"><table width="100%" border="0">
431 <colgroup>
432 <col width="150px" class="parameters_name">
433 <col class="parameters_description">
434 <col width="200px" class="parameters_annotations">
435 </colgroup>
436 <tbody><tr>
437 <td class="parameter_name"><p>dict</p></td>
438 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
439 <td class="parameter_annotations"> </td>
440 </tr></tbody>
441 </table></div>
442 </div>
443 <div class="refsect3">
444 <a name="id-1.5.3.7.8.7"></a><h4>Returns</h4>
445 <p> <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariantBuilder"><span class="type">GVariantBuilder</span></a> if successful, NULL otherwise. </p>
446 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
447 </div>
448 </div>
449 <hr>
450 <div class="refsect2">
451 <a name="gsignond-dictionary-get"></a><h3>gsignond_dictionary_get ()</h3>
452 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
453 gsignond_dictionary_get (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
454                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
455 <p>Retrieves a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> value from the dictionary. This can be used to retrieve
456 a value of an arbitrary type, and then convert it manually to a specific type
457 using <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> methods. For most commonly used types, also getters that
458 return the specific type directly are provided (<a class="link" href="gsignond-GSignondDictionary.html#gsignond-dictionary-get-string" title="gsignond_dictionary_get_string ()"><code class="function">gsignond_dictionary_get_string()</code></a>
459 and similar).</p>
460 <div class="refsect3">
461 <a name="id-1.5.3.7.9.5"></a><h4>Parameters</h4>
462 <div class="informaltable"><table width="100%" border="0">
463 <colgroup>
464 <col width="150px" class="parameters_name">
465 <col class="parameters_description">
466 <col width="200px" class="parameters_annotations">
467 </colgroup>
468 <tbody>
469 <tr>
470 <td class="parameter_name"><p>dict</p></td>
471 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
472 <td class="parameter_annotations"> </td>
473 </tr>
474 <tr>
475 <td class="parameter_name"><p>key</p></td>
476 <td class="parameter_description"><p>the key to look up in the dictionary</p></td>
477 <td class="parameter_annotations"> </td>
478 </tr>
479 </tbody>
480 </table></div>
481 </div>
482 <div class="refsect3">
483 <a name="id-1.5.3.7.9.6"></a><h4>Returns</h4>
484 <p> the value; NULL is returned in case of failure (for
485 example if the entry corresponding to the supplied key doesn't exist). </p>
486 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
487 </div>
488 </div>
489 <hr>
490 <div class="refsect2">
491 <a name="gsignond-dictionary-set"></a><h3>gsignond_dictionary_set ()</h3>
492 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
493 gsignond_dictionary_set (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
494                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
495                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
496 <p>Adds or replaces key-value pair in the dictionary. This allows to set a value
497 of an arbitrary type: it first needs to be converted to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>. For most
498 commonly used types also type-specific setters are provided.</p>
499 <div class="refsect3">
500 <a name="id-1.5.3.7.10.5"></a><h4>Parameters</h4>
501 <div class="informaltable"><table width="100%" border="0">
502 <colgroup>
503 <col width="150px" class="parameters_name">
504 <col class="parameters_description">
505 <col width="200px" class="parameters_annotations">
506 </colgroup>
507 <tbody>
508 <tr>
509 <td class="parameter_name"><p>dict</p></td>
510 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
511 <td class="parameter_annotations"> </td>
512 </tr>
513 <tr>
514 <td class="parameter_name"><p>key</p></td>
515 <td class="parameter_description"><p> key to be set. </p></td>
516 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
517 </tr>
518 <tr>
519 <td class="parameter_name"><p>value</p></td>
520 <td class="parameter_description"><p> value to be set. </p></td>
521 <td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
522 </tr>
523 </tbody>
524 </table></div>
525 </div>
526 <div class="refsect3">
527 <a name="id-1.5.3.7.10.6"></a><h4>Returns</h4>
528 <p> TRUE if successful, FALSE otherwise.</p>
529 <p></p>
530 </div>
531 </div>
532 <hr>
533 <div class="refsect2">
534 <a name="gsignond-dictionary-get-boolean"></a><h3>gsignond_dictionary_get_boolean ()</h3>
535 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
536 gsignond_dictionary_get_boolean (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
537                                  <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
538                                  <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *value</code></em>);</pre>
539 <p>Retrieves a gboolean value.</p>
540 <div class="refsect3">
541 <a name="id-1.5.3.7.11.5"></a><h4>Parameters</h4>
542 <div class="informaltable"><table width="100%" border="0">
543 <colgroup>
544 <col width="150px" class="parameters_name">
545 <col class="parameters_description">
546 <col width="200px" class="parameters_annotations">
547 </colgroup>
548 <tbody>
549 <tr>
550 <td class="parameter_name"><p>dict</p></td>
551 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
552 <td class="parameter_annotations"> </td>
553 </tr>
554 <tr>
555 <td class="parameter_name"><p>key</p></td>
556 <td class="parameter_description"><p> key to look up. </p></td>
557 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
558 </tr>
559 <tr>
560 <td class="parameter_name"><p>value</p></td>
561 <td class="parameter_description"><p>points to the location where the value should be set</p></td>
562 <td class="parameter_annotations"> </td>
563 </tr>
564 </tbody>
565 </table></div>
566 </div>
567 <div class="refsect3">
568 <a name="id-1.5.3.7.11.6"></a><h4>Returns</h4>
569 <p> TRUE if the value was retrieved successfully, FALSE otherwise.</p>
570 <p></p>
571 </div>
572 </div>
573 <hr>
574 <div class="refsect2">
575 <a name="gsignond-dictionary-set-boolean"></a><h3>gsignond_dictionary_set_boolean ()</h3>
576 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
577 gsignond_dictionary_set_boolean (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
578                                  <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
579                                  <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);</pre>
580 <p>Sets or replaces a gboolean value in the dictionary.</p>
581 <div class="refsect3">
582 <a name="id-1.5.3.7.12.5"></a><h4>Parameters</h4>
583 <div class="informaltable"><table width="100%" border="0">
584 <colgroup>
585 <col width="150px" class="parameters_name">
586 <col class="parameters_description">
587 <col width="200px" class="parameters_annotations">
588 </colgroup>
589 <tbody>
590 <tr>
591 <td class="parameter_name"><p>dict</p></td>
592 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
593 <td class="parameter_annotations"> </td>
594 </tr>
595 <tr>
596 <td class="parameter_name"><p>key</p></td>
597 <td class="parameter_description"><p> key to set. </p></td>
598 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
599 </tr>
600 <tr>
601 <td class="parameter_name"><p>value</p></td>
602 <td class="parameter_description"><p>value to set</p></td>
603 <td class="parameter_annotations"> </td>
604 </tr>
605 </tbody>
606 </table></div>
607 </div>
608 <div class="refsect3">
609 <a name="id-1.5.3.7.12.6"></a><h4>Returns</h4>
610 <p> TRUE if the value was set or replaced successfully, FALSE otherwise.</p>
611 <p></p>
612 </div>
613 </div>
614 <hr>
615 <div class="refsect2">
616 <a name="gsignond-dictionary-get-int32"></a><h3>gsignond_dictionary_get_int32 ()</h3>
617 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
618 gsignond_dictionary_get_int32 (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
619                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
620                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *value</code></em>);</pre>
621 <p>Retrieves a int32 value.</p>
622 <div class="refsect3">
623 <a name="id-1.5.3.7.13.5"></a><h4>Parameters</h4>
624 <div class="informaltable"><table width="100%" border="0">
625 <colgroup>
626 <col width="150px" class="parameters_name">
627 <col class="parameters_description">
628 <col width="200px" class="parameters_annotations">
629 </colgroup>
630 <tbody>
631 <tr>
632 <td class="parameter_name"><p>dict</p></td>
633 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
634 <td class="parameter_annotations"> </td>
635 </tr>
636 <tr>
637 <td class="parameter_name"><p>key</p></td>
638 <td class="parameter_description"><p> key to look up. </p></td>
639 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
640 </tr>
641 <tr>
642 <td class="parameter_name"><p>value</p></td>
643 <td class="parameter_description"><p>points to the location where the value should be set</p></td>
644 <td class="parameter_annotations"> </td>
645 </tr>
646 </tbody>
647 </table></div>
648 </div>
649 <div class="refsect3">
650 <a name="id-1.5.3.7.13.6"></a><h4>Returns</h4>
651 <p> TRUE if the value was retrieved successfully, FALSE otherwise.</p>
652 <p></p>
653 </div>
654 </div>
655 <hr>
656 <div class="refsect2">
657 <a name="gsignond-dictionary-set-int32"></a><h3>gsignond_dictionary_set_int32 ()</h3>
658 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
659 gsignond_dictionary_set_int32 (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
660                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
661                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> value</code></em>);</pre>
662 <p>Sets or replaces a int32 value in the dictionary.</p>
663 <div class="refsect3">
664 <a name="id-1.5.3.7.14.5"></a><h4>Parameters</h4>
665 <div class="informaltable"><table width="100%" border="0">
666 <colgroup>
667 <col width="150px" class="parameters_name">
668 <col class="parameters_description">
669 <col width="200px" class="parameters_annotations">
670 </colgroup>
671 <tbody>
672 <tr>
673 <td class="parameter_name"><p>dict</p></td>
674 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
675 <td class="parameter_annotations"> </td>
676 </tr>
677 <tr>
678 <td class="parameter_name"><p>key</p></td>
679 <td class="parameter_description"><p> key to set. </p></td>
680 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
681 </tr>
682 <tr>
683 <td class="parameter_name"><p>value</p></td>
684 <td class="parameter_description"><p>value to set</p></td>
685 <td class="parameter_annotations"> </td>
686 </tr>
687 </tbody>
688 </table></div>
689 </div>
690 <div class="refsect3">
691 <a name="id-1.5.3.7.14.6"></a><h4>Returns</h4>
692 <p> TRUE if the value was set or replaced successfully, FALSE otherwise.</p>
693 <p></p>
694 </div>
695 </div>
696 <hr>
697 <div class="refsect2">
698 <a name="gsignond-dictionary-get-uint32"></a><h3>gsignond_dictionary_get_uint32 ()</h3>
699 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
700 gsignond_dictionary_get_uint32 (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
701                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
702                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *value</code></em>);</pre>
703 <p>Retrieves a uint32 value.</p>
704 <div class="refsect3">
705 <a name="id-1.5.3.7.15.5"></a><h4>Parameters</h4>
706 <div class="informaltable"><table width="100%" border="0">
707 <colgroup>
708 <col width="150px" class="parameters_name">
709 <col class="parameters_description">
710 <col width="200px" class="parameters_annotations">
711 </colgroup>
712 <tbody>
713 <tr>
714 <td class="parameter_name"><p>dict</p></td>
715 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
716 <td class="parameter_annotations"> </td>
717 </tr>
718 <tr>
719 <td class="parameter_name"><p>key</p></td>
720 <td class="parameter_description"><p> key to look up. </p></td>
721 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
722 </tr>
723 <tr>
724 <td class="parameter_name"><p>value</p></td>
725 <td class="parameter_description"><p>points to the location where the value should be set</p></td>
726 <td class="parameter_annotations"> </td>
727 </tr>
728 </tbody>
729 </table></div>
730 </div>
731 <div class="refsect3">
732 <a name="id-1.5.3.7.15.6"></a><h4>Returns</h4>
733 <p> TRUE if the value was retrieved successfully, FALSE otherwise.</p>
734 <p></p>
735 </div>
736 </div>
737 <hr>
738 <div class="refsect2">
739 <a name="gsignond-dictionary-set-uint32"></a><h3>gsignond_dictionary_set_uint32 ()</h3>
740 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
741 gsignond_dictionary_set_uint32 (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
742                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
743                                 <em class="parameter"><code><span class="type">guint32</span> value</code></em>);</pre>
744 <p>Sets or replaces a uint32 value in the dictionary.</p>
745 <div class="refsect3">
746 <a name="id-1.5.3.7.16.5"></a><h4>Parameters</h4>
747 <div class="informaltable"><table width="100%" border="0">
748 <colgroup>
749 <col width="150px" class="parameters_name">
750 <col class="parameters_description">
751 <col width="200px" class="parameters_annotations">
752 </colgroup>
753 <tbody>
754 <tr>
755 <td class="parameter_name"><p>dict</p></td>
756 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
757 <td class="parameter_annotations"> </td>
758 </tr>
759 <tr>
760 <td class="parameter_name"><p>key</p></td>
761 <td class="parameter_description"><p> key to set. </p></td>
762 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
763 </tr>
764 <tr>
765 <td class="parameter_name"><p>value</p></td>
766 <td class="parameter_description"><p>value to set</p></td>
767 <td class="parameter_annotations"> </td>
768 </tr>
769 </tbody>
770 </table></div>
771 </div>
772 <div class="refsect3">
773 <a name="id-1.5.3.7.16.6"></a><h4>Returns</h4>
774 <p> TRUE if the value was set or replaced successfully, FALSE otherwise.</p>
775 <p></p>
776 </div>
777 </div>
778 <hr>
779 <div class="refsect2">
780 <a name="gsignond-dictionary-get-int64"></a><h3>gsignond_dictionary_get_int64 ()</h3>
781 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
782 gsignond_dictionary_get_int64 (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
783                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
784                                <em class="parameter"><code><span class="type">gint64</span> *value</code></em>);</pre>
785 <p>Retrieves a int64 value.</p>
786 <div class="refsect3">
787 <a name="id-1.5.3.7.17.5"></a><h4>Parameters</h4>
788 <div class="informaltable"><table width="100%" border="0">
789 <colgroup>
790 <col width="150px" class="parameters_name">
791 <col class="parameters_description">
792 <col width="200px" class="parameters_annotations">
793 </colgroup>
794 <tbody>
795 <tr>
796 <td class="parameter_name"><p>dict</p></td>
797 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
798 <td class="parameter_annotations"> </td>
799 </tr>
800 <tr>
801 <td class="parameter_name"><p>key</p></td>
802 <td class="parameter_description"><p> key to look up. </p></td>
803 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
804 </tr>
805 <tr>
806 <td class="parameter_name"><p>value</p></td>
807 <td class="parameter_description"><p>points to the location where the value should be set</p></td>
808 <td class="parameter_annotations"> </td>
809 </tr>
810 </tbody>
811 </table></div>
812 </div>
813 <div class="refsect3">
814 <a name="id-1.5.3.7.17.6"></a><h4>Returns</h4>
815 <p> TRUE if the value was retrieved successfully, FALSE otherwise.</p>
816 <p></p>
817 </div>
818 </div>
819 <hr>
820 <div class="refsect2">
821 <a name="gsignond-dictionary-set-int64"></a><h3>gsignond_dictionary_set_int64 ()</h3>
822 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
823 gsignond_dictionary_set_int64 (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
824                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
825                                <em class="parameter"><code><span class="type">gint64</span> value</code></em>);</pre>
826 <p>Sets or replaces a int64 value in the dictionary.</p>
827 <div class="refsect3">
828 <a name="id-1.5.3.7.18.5"></a><h4>Parameters</h4>
829 <div class="informaltable"><table width="100%" border="0">
830 <colgroup>
831 <col width="150px" class="parameters_name">
832 <col class="parameters_description">
833 <col width="200px" class="parameters_annotations">
834 </colgroup>
835 <tbody>
836 <tr>
837 <td class="parameter_name"><p>dict</p></td>
838 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
839 <td class="parameter_annotations"> </td>
840 </tr>
841 <tr>
842 <td class="parameter_name"><p>key</p></td>
843 <td class="parameter_description"><p> key to set. </p></td>
844 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
845 </tr>
846 <tr>
847 <td class="parameter_name"><p>value</p></td>
848 <td class="parameter_description"><p>value to set</p></td>
849 <td class="parameter_annotations"> </td>
850 </tr>
851 </tbody>
852 </table></div>
853 </div>
854 <div class="refsect3">
855 <a name="id-1.5.3.7.18.6"></a><h4>Returns</h4>
856 <p> TRUE if the value was set or replaced successfully, FALSE otherwise.</p>
857 <p></p>
858 </div>
859 </div>
860 <hr>
861 <div class="refsect2">
862 <a name="gsignond-dictionary-get-uint64"></a><h3>gsignond_dictionary_get_uint64 ()</h3>
863 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
864 gsignond_dictionary_get_uint64 (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
865                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
866                                 <em class="parameter"><code><span class="type">guint64</span> *value</code></em>);</pre>
867 <p>Retrieves a uint64 value.</p>
868 <div class="refsect3">
869 <a name="id-1.5.3.7.19.5"></a><h4>Parameters</h4>
870 <div class="informaltable"><table width="100%" border="0">
871 <colgroup>
872 <col width="150px" class="parameters_name">
873 <col class="parameters_description">
874 <col width="200px" class="parameters_annotations">
875 </colgroup>
876 <tbody>
877 <tr>
878 <td class="parameter_name"><p>dict</p></td>
879 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
880 <td class="parameter_annotations"> </td>
881 </tr>
882 <tr>
883 <td class="parameter_name"><p>key</p></td>
884 <td class="parameter_description"><p> key to look up. </p></td>
885 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
886 </tr>
887 <tr>
888 <td class="parameter_name"><p>value</p></td>
889 <td class="parameter_description"><p>points to the location where the value should be set</p></td>
890 <td class="parameter_annotations"> </td>
891 </tr>
892 </tbody>
893 </table></div>
894 </div>
895 <div class="refsect3">
896 <a name="id-1.5.3.7.19.6"></a><h4>Returns</h4>
897 <p> TRUE if the value was retrieved successfully, FALSE otherwise.</p>
898 <p></p>
899 </div>
900 </div>
901 <hr>
902 <div class="refsect2">
903 <a name="gsignond-dictionary-set-uint64"></a><h3>gsignond_dictionary_set_uint64 ()</h3>
904 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
905 gsignond_dictionary_set_uint64 (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
906                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
907                                 <em class="parameter"><code><span class="type">guint64</span> value</code></em>);</pre>
908 <p>Sets or replaces a uint64 value in the dictionary.</p>
909 <div class="refsect3">
910 <a name="id-1.5.3.7.20.5"></a><h4>Parameters</h4>
911 <div class="informaltable"><table width="100%" border="0">
912 <colgroup>
913 <col width="150px" class="parameters_name">
914 <col class="parameters_description">
915 <col width="200px" class="parameters_annotations">
916 </colgroup>
917 <tbody>
918 <tr>
919 <td class="parameter_name"><p>dict</p></td>
920 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
921 <td class="parameter_annotations"> </td>
922 </tr>
923 <tr>
924 <td class="parameter_name"><p>key</p></td>
925 <td class="parameter_description"><p> key to set. </p></td>
926 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
927 </tr>
928 <tr>
929 <td class="parameter_name"><p>value</p></td>
930 <td class="parameter_description"><p>value to set</p></td>
931 <td class="parameter_annotations"> </td>
932 </tr>
933 </tbody>
934 </table></div>
935 </div>
936 <div class="refsect3">
937 <a name="id-1.5.3.7.20.6"></a><h4>Returns</h4>
938 <p> TRUE if the value was set or replaced successfully, FALSE otherwise.</p>
939 <p></p>
940 </div>
941 </div>
942 <hr>
943 <div class="refsect2">
944 <a name="gsignond-dictionary-get-string"></a><h3>gsignond_dictionary_get_string ()</h3>
945 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
946 gsignond_dictionary_get_string (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
947                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
948 <p>Retrieves a string value.</p>
949 <div class="refsect3">
950 <a name="id-1.5.3.7.21.5"></a><h4>Parameters</h4>
951 <div class="informaltable"><table width="100%" border="0">
952 <colgroup>
953 <col width="150px" class="parameters_name">
954 <col class="parameters_description">
955 <col width="200px" class="parameters_annotations">
956 </colgroup>
957 <tbody>
958 <tr>
959 <td class="parameter_name"><p>dict</p></td>
960 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
961 <td class="parameter_annotations"> </td>
962 </tr>
963 <tr>
964 <td class="parameter_name"><p>key</p></td>
965 <td class="parameter_description"><p> key to look up. </p></td>
966 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
967 </tr>
968 </tbody>
969 </table></div>
970 </div>
971 <div class="refsect3">
972 <a name="id-1.5.3.7.21.6"></a><h4>Returns</h4>
973 <p> the value if it was retrieved successfully, NULL otherwise. </p>
974 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
975 </div>
976 </div>
977 <hr>
978 <div class="refsect2">
979 <a name="gsignond-dictionary-set-string"></a><h3>gsignond_dictionary_set_string ()</h3>
980 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
981 gsignond_dictionary_set_string (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
982                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
983                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
984 <p>Sets or replaces a string value in the dictionary.</p>
985 <div class="refsect3">
986 <a name="id-1.5.3.7.22.5"></a><h4>Parameters</h4>
987 <div class="informaltable"><table width="100%" border="0">
988 <colgroup>
989 <col width="150px" class="parameters_name">
990 <col class="parameters_description">
991 <col width="200px" class="parameters_annotations">
992 </colgroup>
993 <tbody>
994 <tr>
995 <td class="parameter_name"><p>dict</p></td>
996 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
997 <td class="parameter_annotations"> </td>
998 </tr>
999 <tr>
1000 <td class="parameter_name"><p>key</p></td>
1001 <td class="parameter_description"><p> key to set. </p></td>
1002 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
1003 </tr>
1004 <tr>
1005 <td class="parameter_name"><p>value</p></td>
1006 <td class="parameter_description"><p> value to set. </p></td>
1007 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
1008 </tr>
1009 </tbody>
1010 </table></div>
1011 </div>
1012 <div class="refsect3">
1013 <a name="id-1.5.3.7.22.6"></a><h4>Returns</h4>
1014 <p> TRUE if the value was set or replaced successfully, FALSE otherwise.</p>
1015 <p></p>
1016 </div>
1017 </div>
1018 <hr>
1019 <div class="refsect2">
1020 <a name="gsignond-dictionary-remove"></a><h3>gsignond_dictionary_remove ()</h3>
1021 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1022 gsignond_dictionary_remove (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
1023                             <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
1024 <p>Removes key-value pair in the dictionary as per key.</p>
1025 <div class="refsect3">
1026 <a name="id-1.5.3.7.23.5"></a><h4>Parameters</h4>
1027 <div class="informaltable"><table width="100%" border="0">
1028 <colgroup>
1029 <col width="150px" class="parameters_name">
1030 <col class="parameters_description">
1031 <col width="200px" class="parameters_annotations">
1032 </colgroup>
1033 <tbody>
1034 <tr>
1035 <td class="parameter_name"><p>dict</p></td>
1036 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
1037 <td class="parameter_annotations"> </td>
1038 </tr>
1039 <tr>
1040 <td class="parameter_name"><p>key</p></td>
1041 <td class="parameter_description"><p> key which needs to be removed from the dictionary. </p></td>
1042 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
1043 </tr>
1044 </tbody>
1045 </table></div>
1046 </div>
1047 <div class="refsect3">
1048 <a name="id-1.5.3.7.23.6"></a><h4>Returns</h4>
1049 <p> TRUE if successful, FALSE otherwise.</p>
1050 <p></p>
1051 </div>
1052 </div>
1053 <hr>
1054 <div class="refsect2">
1055 <a name="gsignond-dictionary-contains"></a><h3>gsignond_dictionary_contains ()</h3>
1056 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1057 gsignond_dictionary_contains (<em class="parameter"><code><a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a> *dict</code></em>,
1058                               <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
1059 <p>Checks if the <em class="parameter"><code>dict</code></em>
1060  contains <em class="parameter"><code>key</code></em>
1061 .</p>
1062 <div class="refsect3">
1063 <a name="id-1.5.3.7.24.5"></a><h4>Parameters</h4>
1064 <div class="informaltable"><table width="100%" border="0">
1065 <colgroup>
1066 <col width="150px" class="parameters_name">
1067 <col class="parameters_description">
1068 <col width="200px" class="parameters_annotations">
1069 </colgroup>
1070 <tbody>
1071 <tr>
1072 <td class="parameter_name"><p>dict</p></td>
1073 <td class="parameter_description"><p>instance of <a href="http://gsignon-docs.accounts-sso.googlecode.com/git/gsignond/gsignond-GSignondDictionary.html#GSignondDictionary"><span class="type">GSignondDictionary</span></a></p></td>
1074 <td class="parameter_annotations"> </td>
1075 </tr>
1076 <tr>
1077 <td class="parameter_name"><p>key</p></td>
1078 <td class="parameter_description"><p> key to check. </p></td>
1079 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
1080 </tr>
1081 </tbody>
1082 </table></div>
1083 </div>
1084 <div class="refsect3">
1085 <a name="id-1.5.3.7.24.6"></a><h4>Returns</h4>
1086 <p> TRUE if found, FALSE otherwise.</p>
1087 <p></p>
1088 </div>
1089 </div>
1090 </div>
1091 <div class="refsect1">
1092 <a name="gsignond-GSignondDictionary.other_details"></a><h2>Types and Values</h2>
1093 </div>
1094 </div>
1095 <div class="footer">
1096 <hr>
1097           Generated by GTK-Doc V1.20</div>
1098 </body>
1099 </html>