1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
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">
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>
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>
26 <div class="refentry">
27 <a name="gsignond-GSignondDictionary"></a><div class="titlepage"></div>
28 <div class="refnamediv"><table width="100%"><tr>
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>
33 <td class="gallery_image" valign="top" align="right"></td>
35 <div class="refsect1">
36 <a name="gsignond-GSignondDictionary.functions"></a><h2>Functions</h2>
37 <div class="informaltable"><table width="100%" border="0">
39 <col width="150px" class="functions_return">
40 <col class="functions_name">
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> *
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>
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> *
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>
60 <td class="function_type">
61 <span class="returnvalue">void</span>
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>
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> *
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>
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> *
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>
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> *
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>
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> *
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>
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> *
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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> *
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>
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>
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>
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>
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>
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>
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>
229 <div class="refsect1">
230 <a name="gsignond-GSignondDictionary.object-hierarchy"></a><h2>Object Hierarchy</h2>
234 <div class="refsect1">
235 <a name="gsignond-GSignondDictionary.includes"></a><h2>Includes</h2>
236 <pre class="synopsis">#include <gsignond/gsignond-dictionary.h>
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
244 <div class="informalexample">
245 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
248 <td class="listing_lines" align="right"><pre>1
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">"name"</span><span class="gtkdoc opt">,</span> <span class="string">"John Smith"</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">"age"</span><span class="gtkdoc opt">,</span> <span class="number">32</span><span class="gtkdoc opt">);</span>
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">"age"</span><span class="gtkdoc opt">, &</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">"name"</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>
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,
280 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
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">
293 <col width="150px" class="parameters_name">
294 <col class="parameters_description">
295 <col width="200px" class="parameters_annotations">
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>
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>
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">
321 <col width="150px" class="parameters_name">
322 <col class="parameters_description">
323 <col width="200px" class="parameters_annotations">
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>
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">
343 <col width="150px" class="parameters_name">
344 <col class="parameters_description">
345 <col width="200px" class="parameters_annotations">
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>
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,
358 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
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">
373 <col width="150px" class="parameters_name">
374 <col class="parameters_description">
375 <col width="200px" class="parameters_annotations">
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>
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>
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">
401 <col width="150px" class="parameters_name">
402 <col class="parameters_description">
403 <col width="200px" class="parameters_annotations">
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>
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>
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">
432 <col width="150px" class="parameters_name">
433 <col class="parameters_description">
434 <col width="200px" class="parameters_annotations">
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>
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>
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>
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">
464 <col width="150px" class="parameters_name">
465 <col class="parameters_description">
466 <col width="200px" class="parameters_annotations">
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>
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>
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>
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">
503 <col width="150px" class="parameters_name">
504 <col class="parameters_description">
505 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
544 <col width="150px" class="parameters_name">
545 <col class="parameters_description">
546 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
585 <col width="150px" class="parameters_name">
586 <col class="parameters_description">
587 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
626 <col width="150px" class="parameters_name">
627 <col class="parameters_description">
628 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
667 <col width="150px" class="parameters_name">
668 <col class="parameters_description">
669 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
708 <col width="150px" class="parameters_name">
709 <col class="parameters_description">
710 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
749 <col width="150px" class="parameters_name">
750 <col class="parameters_description">
751 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
790 <col width="150px" class="parameters_name">
791 <col class="parameters_description">
792 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
831 <col width="150px" class="parameters_name">
832 <col class="parameters_description">
833 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
872 <col width="150px" class="parameters_name">
873 <col class="parameters_description">
874 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
913 <col width="150px" class="parameters_name">
914 <col class="parameters_description">
915 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
953 <col width="150px" class="parameters_name">
954 <col class="parameters_description">
955 <col width="200px" class="parameters_annotations">
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>
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>
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>
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">
989 <col width="150px" class="parameters_name">
990 <col class="parameters_description">
991 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
1029 <col width="150px" class="parameters_name">
1030 <col class="parameters_description">
1031 <col width="200px" class="parameters_annotations">
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>
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>
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>
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>
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">
1066 <col width="150px" class="parameters_name">
1067 <col class="parameters_description">
1068 <col width="200px" class="parameters_annotations">
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>
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>
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>
1091 <div class="refsect1">
1092 <a name="gsignond-GSignondDictionary.other_details"></a><h2>Types and Values</h2>
1095 <div class="footer">
1097 Generated by GTK-Doc V1.20</div>