Initial Import
[profile/ivi/json-glib.git] / doc / reference / html / json-glib-JSON-Object.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>JSON Object</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="JSON-GLib Reference Manual">
8 <link rel="up" href="ch01.html" title="Data Types">
9 <link rel="prev" href="json-glib-JSON-Array.html" title="JSON Array">
10 <link rel="next" href="json-streams.html" title="Part III. Reading and writing">
11 <meta name="generator" content="GTK-Doc V1.18.1 (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="2">
16 <tr valign="middle">
17 <td><a accesskey="p" href="json-glib-JSON-Array.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">JSON-GLib Reference Manual</th>
21 <td><a accesskey="n" href="json-streams.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22 </tr>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#json-glib-JSON-Object.synopsis" class="shortcut">Top</a>
25                    | 
26                   <a href="#json-glib-JSON-Object.description" class="shortcut">Description</a>
27 </td></tr>
28 </table>
29 <div class="refentry">
30 <a name="json-glib-JSON-Object"></a><div class="titlepage"></div>
31 <div class="refnamediv"><table width="100%"><tr>
32 <td valign="top">
33 <h2><span class="refentrytitle"><a name="json-glib-JSON-Object.top_of_page"></a>JSON Object</span></h2>
34 <p>JSON Object — a JSON object representation</p>
35 </td>
36 <td valign="top" align="right"></td>
37 </tr></table></div>
38 <div class="refsynopsisdiv">
39 <a name="json-glib-JSON-Object.synopsis"></a><h2>Synopsis</h2>
40 <pre class="synopsis">                    <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject">JsonObject</a>;
41 <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="returnvalue">JsonObject</span></a> *        <a class="link" href="json-glib-JSON-Object.html#json-object-new" title="json_object_new ()">json_object_new</a>                     (<em class="parameter"><code><span class="type">void</span></code></em>);
42 <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="returnvalue">JsonObject</span></a> *        <a class="link" href="json-glib-JSON-Object.html#json-object-ref" title="json_object_ref ()">json_object_ref</a>                     (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);
43 <span class="returnvalue">void</span>                <a class="link" href="json-glib-JSON-Object.html#json-object-unref" title="json_object_unref ()">json_object_unref</a>                   (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);
44
45 <span class="returnvalue">void</span>                <a class="link" href="json-glib-JSON-Object.html#json-object-add-member" title="json_object_add_member ()">json_object_add_member</a>              (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
46                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
47                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);
48 <span class="returnvalue">void</span>                <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()">json_object_set_member</a>              (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
49                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
50                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);
51 <span class="returnvalue">gboolean</span>            <a class="link" href="json-glib-JSON-Object.html#json-object-has-member" title="json_object_has_member ()">json_object_has_member</a>              (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
52                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
53 <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> *          <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()">json_object_get_member</a>              (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
54                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
55 <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> *          <a class="link" href="json-glib-JSON-Object.html#json-object-dup-member" title="json_object_dup_member ()">json_object_dup_member</a>              (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
56                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
57 <span class="returnvalue">GList</span> *             <a class="link" href="json-glib-JSON-Object.html#json-object-get-members" title="json_object_get_members ()">json_object_get_members</a>             (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);
58 <span class="returnvalue">GList</span> *             <a class="link" href="json-glib-JSON-Object.html#json-object-get-values" title="json_object_get_values ()">json_object_get_values</a>              (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);
59 <span class="returnvalue">guint</span>               <a class="link" href="json-glib-JSON-Object.html#json-object-get-size" title="json_object_get_size ()">json_object_get_size</a>                (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);
60 <span class="returnvalue">void</span>                <a class="link" href="json-glib-JSON-Object.html#json-object-remove-member" title="json_object_remove_member ()">json_object_remove_member</a>           (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
61                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
62 <span class="returnvalue">void</span>                (<a class="link" href="json-glib-JSON-Object.html#JsonObjectForeach" title="JsonObjectForeach ()">*JsonObjectForeach</a>)                (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
63                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
64                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *member_node</code></em>,
65                                                          <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
66 <span class="returnvalue">void</span>                <a class="link" href="json-glib-JSON-Object.html#json-object-foreach-member" title="json_object_foreach_member ()">json_object_foreach_member</a>          (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
67                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObjectForeach" title="JsonObjectForeach ()"><span class="type">JsonObjectForeach</span></a> func</code></em>,
68                                                          <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
69
70 <span class="returnvalue">void</span>                <a class="link" href="json-glib-JSON-Object.html#json-object-set-array-member" title="json_object_set_array_member ()">json_object_set_array_member</a>        (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
71                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
72                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray" title="JsonArray"><span class="type">JsonArray</span></a> *value</code></em>);
73 <a class="link" href="json-glib-JSON-Array.html#JsonArray" title="JsonArray"><span class="returnvalue">JsonArray</span></a> *         <a class="link" href="json-glib-JSON-Object.html#json-object-get-array-member" title="json_object_get_array_member ()">json_object_get_array_member</a>        (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
74                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
75 <span class="returnvalue">void</span>                <a class="link" href="json-glib-JSON-Object.html#json-object-set-boolean-member" title="json_object_set_boolean_member ()">json_object_set_boolean_member</a>      (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
76                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
77                                                          <em class="parameter"><code><span class="type">gboolean</span> value</code></em>);
78 <span class="returnvalue">gboolean</span>            <a class="link" href="json-glib-JSON-Object.html#json-object-get-boolean-member" title="json_object_get_boolean_member ()">json_object_get_boolean_member</a>      (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
79                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
80 <span class="returnvalue">void</span>                <a class="link" href="json-glib-JSON-Object.html#json-object-set-double-member" title="json_object_set_double_member ()">json_object_set_double_member</a>       (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
81                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
82                                                          <em class="parameter"><code><span class="type">gdouble</span> value</code></em>);
83 <span class="returnvalue">gdouble</span>             <a class="link" href="json-glib-JSON-Object.html#json-object-get-double-member" title="json_object_get_double_member ()">json_object_get_double_member</a>       (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
84                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
85 <span class="returnvalue">void</span>                <a class="link" href="json-glib-JSON-Object.html#json-object-set-int-member" title="json_object_set_int_member ()">json_object_set_int_member</a>          (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
86                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
87                                                          <em class="parameter"><code><span class="type">gint64</span> value</code></em>);
88 <span class="returnvalue">gint64</span>              <a class="link" href="json-glib-JSON-Object.html#json-object-get-int-member" title="json_object_get_int_member ()">json_object_get_int_member</a>          (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
89                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
90 <span class="returnvalue">void</span>                <a class="link" href="json-glib-JSON-Object.html#json-object-set-null-member" title="json_object_set_null_member ()">json_object_set_null_member</a>         (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
91                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
92 <span class="returnvalue">gboolean</span>            <a class="link" href="json-glib-JSON-Object.html#json-object-get-null-member" title="json_object_get_null_member ()">json_object_get_null_member</a>         (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
93                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
94 <span class="returnvalue">void</span>                <a class="link" href="json-glib-JSON-Object.html#json-object-set-object-member" title="json_object_set_object_member ()">json_object_set_object_member</a>       (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
95                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
96                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *value</code></em>);
97 <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="returnvalue">JsonObject</span></a> *        <a class="link" href="json-glib-JSON-Object.html#json-object-get-object-member" title="json_object_get_object_member ()">json_object_get_object_member</a>       (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
98                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
99 <span class="returnvalue">void</span>                <a class="link" href="json-glib-JSON-Object.html#json-object-set-string-member" title="json_object_set_string_member ()">json_object_set_string_member</a>       (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
100                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
101                                                          <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);
102 const <span class="returnvalue">gchar</span> *       <a class="link" href="json-glib-JSON-Object.html#json-object-get-string-member" title="json_object_get_string_member ()">json_object_get_string_member</a>       (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
103                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
104 </pre>
105 </div>
106 <div class="refsect1">
107 <a name="json-glib-JSON-Object.description"></a><h2>Description</h2>
108 <p>
109 <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> is the representation of the object type inside JSON. It contains
110 <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a>s, which may contain fundamental types, arrays or other
111 objects. Each member of an object is accessed using its name.
112 </p>
113 <p>
114 Since objects can be expensive, they are reference counted. You can control
115 the lifetime of a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> using <a class="link" href="json-glib-JSON-Object.html#json-object-ref" title="json_object_ref ()"><code class="function">json_object_ref()</code></a> and <a class="link" href="json-glib-JSON-Object.html#json-object-unref" title="json_object_unref ()"><code class="function">json_object_unref()</code></a>.
116 </p>
117 <p>
118 To add or overwrite a member with a given name, use <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>.
119 To extract a member with a given name, use <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>.
120 To retrieve the list of members, use <a class="link" href="json-glib-JSON-Object.html#json-object-get-members" title="json_object_get_members ()"><code class="function">json_object_get_members()</code></a>.
121 To retrieve the size of the object (that is, the number of members it has),
122 use <a class="link" href="json-glib-JSON-Object.html#json-object-get-size" title="json_object_get_size ()"><code class="function">json_object_get_size()</code></a>.
123 </p>
124 </div>
125 <div class="refsect1">
126 <a name="json-glib-JSON-Object.details"></a><h2>Details</h2>
127 <div class="refsect2">
128 <a name="JsonObject"></a><h3>JsonObject</h3>
129 <pre class="programlisting">typedef struct _JsonObject JsonObject;</pre>
130 <p>
131 A JSON object type. The contents of the <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> structure are private
132 and should only be accessed by the provided API
133 </p>
134 </div>
135 <hr>
136 <div class="refsect2">
137 <a name="json-object-new"></a><h3>json_object_new ()</h3>
138 <pre class="programlisting"><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="returnvalue">JsonObject</span></a> *        json_object_new                     (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
139 <p>
140 Creates a new <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>, an JSON object type representation.
141 </p>
142 <div class="variablelist"><table border="0">
143 <col align="left" valign="top">
144 <tbody><tr>
145 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
146 <td>the newly created <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
147 </td>
148 </tr></tbody>
149 </table></div>
150 </div>
151 <hr>
152 <div class="refsect2">
153 <a name="json-object-ref"></a><h3>json_object_ref ()</h3>
154 <pre class="programlisting"><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="returnvalue">JsonObject</span></a> *        json_object_ref                     (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
155 <p>
156 Increase by one the reference count of a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>.
157 </p>
158 <div class="variablelist"><table border="0">
159 <col align="left" valign="top">
160 <tbody>
161 <tr>
162 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
163 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
164 </td>
165 </tr>
166 <tr>
167 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
168 <td>the passed <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>, with the reference count
169 increased by one.</td>
170 </tr>
171 </tbody>
172 </table></div>
173 </div>
174 <hr>
175 <div class="refsect2">
176 <a name="json-object-unref"></a><h3>json_object_unref ()</h3>
177 <pre class="programlisting"><span class="returnvalue">void</span>                json_object_unref                   (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
178 <p>
179 Decreases by one the reference count of a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>. If the
180 reference count reaches zero, the object is destroyed and all
181 its allocated resources are freed.
182 </p>
183 <div class="variablelist"><table border="0">
184 <col align="left" valign="top">
185 <tbody><tr>
186 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
187 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
188 </td>
189 </tr></tbody>
190 </table></div>
191 </div>
192 <hr>
193 <div class="refsect2">
194 <a name="json-object-add-member"></a><h3>json_object_add_member ()</h3>
195 <pre class="programlisting"><span class="returnvalue">void</span>                json_object_add_member              (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
196                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
197                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
198 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
199 <h3 class="title">Warning</h3>
200 <p><code class="literal">json_object_add_member</code> has been deprecated since version 0.8 and should not be used in newly-written code. Use <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a> instead</p>
201 </div>
202 <p>
203 Adds a member named <em class="parameter"><code>member_name</code></em> and containing <em class="parameter"><code>node</code></em> into a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>.
204 The object will take ownership of the <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a>.
205 </p>
206 <p>
207 This function will return if the <em class="parameter"><code>object</code></em> already contains a member
208 <em class="parameter"><code>member_name</code></em>.
209 </p>
210 <div class="variablelist"><table border="0">
211 <col align="left" valign="top">
212 <tbody>
213 <tr>
214 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
215 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
216 </td>
217 </tr>
218 <tr>
219 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
220 <td>the name of the member</td>
221 </tr>
222 <tr>
223 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
224 <td>the value of the member. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
225 </td>
226 </tr>
227 </tbody>
228 </table></div>
229 </div>
230 <hr>
231 <div class="refsect2">
232 <a name="json-object-set-member"></a><h3>json_object_set_member ()</h3>
233 <pre class="programlisting"><span class="returnvalue">void</span>                json_object_set_member              (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
234                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
235                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
236 <p>
237 Sets <em class="parameter"><code>node</code></em> as the value of <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
238 </p>
239 <p>
240 If <em class="parameter"><code>object</code></em> already contains a member called <em class="parameter"><code>member_name</code></em> then
241 the member's current value is overwritten. Otherwise, a new
242 member is added to <em class="parameter"><code>object</code></em>.
243 </p>
244 <div class="variablelist"><table border="0">
245 <col align="left" valign="top">
246 <tbody>
247 <tr>
248 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
249 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
250 </td>
251 </tr>
252 <tr>
253 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
254 <td>the name of the member</td>
255 </tr>
256 <tr>
257 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
258 <td>the value of the member. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
259 </td>
260 </tr>
261 </tbody>
262 </table></div>
263 <p class="since">Since 0.8</p>
264 </div>
265 <hr>
266 <div class="refsect2">
267 <a name="json-object-has-member"></a><h3>json_object_has_member ()</h3>
268 <pre class="programlisting"><span class="returnvalue">gboolean</span>            json_object_has_member              (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
269                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
270 <p>
271 Checks whether <em class="parameter"><code>object</code></em> has a member named <em class="parameter"><code>member_name</code></em>.
272 </p>
273 <div class="variablelist"><table border="0">
274 <col align="left" valign="top">
275 <tbody>
276 <tr>
277 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
278 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
279 </td>
280 </tr>
281 <tr>
282 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
283 <td>the name of a JSON object member</td>
284 </tr>
285 <tr>
286 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
287 <td>
288 <code class="literal">TRUE</code> if the JSON object has the requested member</td>
289 </tr>
290 </tbody>
291 </table></div>
292 </div>
293 <hr>
294 <div class="refsect2">
295 <a name="json-object-get-member"></a><h3>json_object_get_member ()</h3>
296 <pre class="programlisting"><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> *          json_object_get_member              (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
297                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
298 <p>
299 Retrieves the <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> containing the value of <em class="parameter"><code>member_name</code></em> inside
300 a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>.
301 </p>
302 <div class="variablelist"><table border="0">
303 <col align="left" valign="top">
304 <tbody>
305 <tr>
306 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
307 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
308 </td>
309 </tr>
310 <tr>
311 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
312 <td>the name of the JSON object member to access</td>
313 </tr>
314 <tr>
315 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
316 <td>a pointer to the node for the requested object
317 member, or <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
318 </td>
319 </tr>
320 </tbody>
321 </table></div>
322 </div>
323 <hr>
324 <div class="refsect2">
325 <a name="json-object-dup-member"></a><h3>json_object_dup_member ()</h3>
326 <pre class="programlisting"><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> *          json_object_dup_member              (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
327                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
328 <p>
329 Retrieves a copy of the <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> containing the value of <em class="parameter"><code>member_name</code></em>
330 inside a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
331 </p>
332 <div class="variablelist"><table border="0">
333 <col align="left" valign="top">
334 <tbody>
335 <tr>
336 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
337 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
338 </td>
339 </tr>
340 <tr>
341 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
342 <td>the name of the JSON object member to access</td>
343 </tr>
344 <tr>
345 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
346 <td>a copy of the node for the requested
347 object member or <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. Use <a class="link" href="json-glib-JSON-Node.html#json-node-free" title="json_node_free ()"><code class="function">json_node_free()</code></a> when done. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
348 </td>
349 </tr>
350 </tbody>
351 </table></div>
352 <p class="since">Since 0.6</p>
353 </div>
354 <hr>
355 <div class="refsect2">
356 <a name="json-object-get-members"></a><h3>json_object_get_members ()</h3>
357 <pre class="programlisting"><span class="returnvalue">GList</span> *             json_object_get_members             (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
358 <p>
359 Retrieves all the names of the members of a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>. You can
360 obtain the value for each member using <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>.
361 </p>
362 <div class="variablelist"><table border="0">
363 <col align="left" valign="top">
364 <tbody>
365 <tr>
366 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
367 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
368 </td>
369 </tr>
370 <tr>
371 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
372 <td>a <span class="type">GList</span>
373 of member names. The content of the list is owned by the <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
374 and should never be modified or freed. When you have finished using
375 the returned list, use <code class="function">g_list_free()</code> to free the resources it has
376 allocated. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
377 </td>
378 </tr>
379 </tbody>
380 </table></div>
381 </div>
382 <hr>
383 <div class="refsect2">
384 <a name="json-object-get-values"></a><h3>json_object_get_values ()</h3>
385 <pre class="programlisting"><span class="returnvalue">GList</span> *             json_object_get_values              (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
386 <p>
387 Retrieves all the values of the members of a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>.
388 </p>
389 <div class="variablelist"><table border="0">
390 <col align="left" valign="top">
391 <tbody>
392 <tr>
393 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
394 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
395 </td>
396 </tr>
397 <tr>
398 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
399 <td>a <span class="type">GList</span> of
400 <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a>s. The content of the list is owned by the <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
401 and should never be modified or freed. When you have finished using the
402 returned list, use <code class="function">g_list_free()</code> to free the resources it has allocated. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> JsonNode][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
403 </td>
404 </tr>
405 </tbody>
406 </table></div>
407 </div>
408 <hr>
409 <div class="refsect2">
410 <a name="json-object-get-size"></a><h3>json_object_get_size ()</h3>
411 <pre class="programlisting"><span class="returnvalue">guint</span>               json_object_get_size                (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
412 <p>
413 Retrieves the number of members of a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>.
414 </p>
415 <div class="variablelist"><table border="0">
416 <col align="left" valign="top">
417 <tbody>
418 <tr>
419 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
420 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
421 </td>
422 </tr>
423 <tr>
424 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
425 <td>the number of members</td>
426 </tr>
427 </tbody>
428 </table></div>
429 </div>
430 <hr>
431 <div class="refsect2">
432 <a name="json-object-remove-member"></a><h3>json_object_remove_member ()</h3>
433 <pre class="programlisting"><span class="returnvalue">void</span>                json_object_remove_member           (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
434                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
435 <p>
436 Removes <em class="parameter"><code>member_name</code></em> from <em class="parameter"><code>object</code></em>, freeing its allocated resources.
437 </p>
438 <div class="variablelist"><table border="0">
439 <col align="left" valign="top">
440 <tbody>
441 <tr>
442 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
443 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
444 </td>
445 </tr>
446 <tr>
447 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
448 <td>the name of the member to remove</td>
449 </tr>
450 </tbody>
451 </table></div>
452 </div>
453 <hr>
454 <div class="refsect2">
455 <a name="JsonObjectForeach"></a><h3>JsonObjectForeach ()</h3>
456 <pre class="programlisting"><span class="returnvalue">void</span>                (*JsonObjectForeach)                (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
457                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
458                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *member_node</code></em>,
459                                                          <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
460 <p>
461 The function to be passed to <a class="link" href="json-glib-JSON-Object.html#json-object-foreach-member" title="json_object_foreach_member ()"><code class="function">json_object_foreach_member()</code></a>. You
462 should not add or remove members to and from <em class="parameter"><code>object</code></em> within
463 this function. It is safe to change the value of <em class="parameter"><code>member_node</code></em>.
464 </p>
465 <div class="variablelist"><table border="0">
466 <col align="left" valign="top">
467 <tbody>
468 <tr>
469 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
470 <td>the iterated <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
471 </td>
472 </tr>
473 <tr>
474 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
475 <td>the name of the member</td>
476 </tr>
477 <tr>
478 <td><p><span class="term"><em class="parameter"><code>member_node</code></em> :</span></p></td>
479 <td>a <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> containing the <em class="parameter"><code>member_name</code></em> value</td>
480 </tr>
481 <tr>
482 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
483 <td>data passed to the function</td>
484 </tr>
485 </tbody>
486 </table></div>
487 <p class="since">Since 0.8</p>
488 </div>
489 <hr>
490 <div class="refsect2">
491 <a name="json-object-foreach-member"></a><h3>json_object_foreach_member ()</h3>
492 <pre class="programlisting"><span class="returnvalue">void</span>                json_object_foreach_member          (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
493                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObjectForeach" title="JsonObjectForeach ()"><span class="type">JsonObjectForeach</span></a> func</code></em>,
494                                                          <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
495 <p>
496 Iterates over all members of <em class="parameter"><code>object</code></em> and calls <em class="parameter"><code>func</code></em> on
497 each one of them.
498 </p>
499 <p>
500 It is safe to change the value of a <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> of the <em class="parameter"><code>object</code></em>
501 from within the iterator <em class="parameter"><code>func</code></em>, but it is not safe to add or
502 remove members from the <em class="parameter"><code>object</code></em>.
503 </p>
504 <div class="variablelist"><table border="0">
505 <col align="left" valign="top">
506 <tbody>
507 <tr>
508 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
509 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
510 </td>
511 </tr>
512 <tr>
513 <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
514 <td>the function to be called on each member. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
515 </td>
516 </tr>
517 <tr>
518 <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
519 <td>data to be passed to the function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
520 </td>
521 </tr>
522 </tbody>
523 </table></div>
524 <p class="since">Since 0.8</p>
525 </div>
526 <hr>
527 <div class="refsect2">
528 <a name="json-object-set-array-member"></a><h3>json_object_set_array_member ()</h3>
529 <pre class="programlisting"><span class="returnvalue">void</span>                json_object_set_array_member        (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
530                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
531                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray" title="JsonArray"><span class="type">JsonArray</span></a> *value</code></em>);</pre>
532 <p>
533 Convenience function for setting an array <em class="parameter"><code>value</code></em> of
534 <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
535 </p>
536 <p>
537 The <em class="parameter"><code>object</code></em> will take ownership of the passed <a class="link" href="json-glib-JSON-Array.html#JsonArray" title="JsonArray"><span class="type">JsonArray</span></a>
538 </p>
539 <p>
540 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
541 </p>
542 <div class="variablelist"><table border="0">
543 <col align="left" valign="top">
544 <tbody>
545 <tr>
546 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
547 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
548 </td>
549 </tr>
550 <tr>
551 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
552 <td>the name of the member</td>
553 </tr>
554 <tr>
555 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
556 <td>the value of the member. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
557 </td>
558 </tr>
559 </tbody>
560 </table></div>
561 <p class="since">Since 0.8</p>
562 </div>
563 <hr>
564 <div class="refsect2">
565 <a name="json-object-get-array-member"></a><h3>json_object_get_array_member ()</h3>
566 <pre class="programlisting"><a class="link" href="json-glib-JSON-Array.html#JsonArray" title="JsonArray"><span class="returnvalue">JsonArray</span></a> *         json_object_get_array_member        (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
567                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
568 <p>
569 Convenience function that retrieves the array
570 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em>
571 </p>
572 <p>
573 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
574 </p>
575 <div class="variablelist"><table border="0">
576 <col align="left" valign="top">
577 <tbody>
578 <tr>
579 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
580 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
581 </td>
582 </tr>
583 <tr>
584 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
585 <td>the name of the member</td>
586 </tr>
587 <tr>
588 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
589 <td>the array inside the object's member. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
590 </td>
591 </tr>
592 </tbody>
593 </table></div>
594 <p class="since">Since 0.8</p>
595 </div>
596 <hr>
597 <div class="refsect2">
598 <a name="json-object-set-boolean-member"></a><h3>json_object_set_boolean_member ()</h3>
599 <pre class="programlisting"><span class="returnvalue">void</span>                json_object_set_boolean_member      (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
600                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
601                                                          <em class="parameter"><code><span class="type">gboolean</span> value</code></em>);</pre>
602 <p>
603 Convenience function for setting a boolean <em class="parameter"><code>value</code></em> of
604 <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
605 </p>
606 <p>
607 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
608 </p>
609 <div class="variablelist"><table border="0">
610 <col align="left" valign="top">
611 <tbody>
612 <tr>
613 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
614 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
615 </td>
616 </tr>
617 <tr>
618 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
619 <td>the name of the member</td>
620 </tr>
621 <tr>
622 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
623 <td>the value of the member</td>
624 </tr>
625 </tbody>
626 </table></div>
627 <p class="since">Since 0.8</p>
628 </div>
629 <hr>
630 <div class="refsect2">
631 <a name="json-object-get-boolean-member"></a><h3>json_object_get_boolean_member ()</h3>
632 <pre class="programlisting"><span class="returnvalue">gboolean</span>            json_object_get_boolean_member      (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
633                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
634 <p>
635 Convenience function that retrieves the boolean value
636 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em>
637 </p>
638 <p>
639 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
640 </p>
641 <div class="variablelist"><table border="0">
642 <col align="left" valign="top">
643 <tbody>
644 <tr>
645 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
646 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
647 </td>
648 </tr>
649 <tr>
650 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
651 <td>the name of the member</td>
652 </tr>
653 <tr>
654 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
655 <td>the boolean value of the object's member</td>
656 </tr>
657 </tbody>
658 </table></div>
659 <p class="since">Since 0.8</p>
660 </div>
661 <hr>
662 <div class="refsect2">
663 <a name="json-object-set-double-member"></a><h3>json_object_set_double_member ()</h3>
664 <pre class="programlisting"><span class="returnvalue">void</span>                json_object_set_double_member       (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
665                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
666                                                          <em class="parameter"><code><span class="type">gdouble</span> value</code></em>);</pre>
667 <p>
668 Convenience function for setting a floating point <em class="parameter"><code>value</code></em>
669 of <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
670 </p>
671 <p>
672 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
673 </p>
674 <div class="variablelist"><table border="0">
675 <col align="left" valign="top">
676 <tbody>
677 <tr>
678 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
679 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
680 </td>
681 </tr>
682 <tr>
683 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
684 <td>the name of the member</td>
685 </tr>
686 <tr>
687 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
688 <td>the value of the member</td>
689 </tr>
690 </tbody>
691 </table></div>
692 <p class="since">Since 0.8</p>
693 </div>
694 <hr>
695 <div class="refsect2">
696 <a name="json-object-get-double-member"></a><h3>json_object_get_double_member ()</h3>
697 <pre class="programlisting"><span class="returnvalue">gdouble</span>             json_object_get_double_member       (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
698                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
699 <p>
700 Convenience function that retrieves the floating point value
701 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em>
702 </p>
703 <p>
704 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
705 </p>
706 <div class="variablelist"><table border="0">
707 <col align="left" valign="top">
708 <tbody>
709 <tr>
710 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
711 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
712 </td>
713 </tr>
714 <tr>
715 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
716 <td>the name of the member</td>
717 </tr>
718 <tr>
719 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
720 <td>the floating point value of the object's member</td>
721 </tr>
722 </tbody>
723 </table></div>
724 <p class="since">Since 0.8</p>
725 </div>
726 <hr>
727 <div class="refsect2">
728 <a name="json-object-set-int-member"></a><h3>json_object_set_int_member ()</h3>
729 <pre class="programlisting"><span class="returnvalue">void</span>                json_object_set_int_member          (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
730                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
731                                                          <em class="parameter"><code><span class="type">gint64</span> value</code></em>);</pre>
732 <p>
733 Convenience function for setting an integer <em class="parameter"><code>value</code></em> of
734 <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
735 </p>
736 <p>
737 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
738 </p>
739 <div class="variablelist"><table border="0">
740 <col align="left" valign="top">
741 <tbody>
742 <tr>
743 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
744 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
745 </td>
746 </tr>
747 <tr>
748 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
749 <td>the name of the member</td>
750 </tr>
751 <tr>
752 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
753 <td>the value of the member</td>
754 </tr>
755 </tbody>
756 </table></div>
757 <p class="since">Since 0.8</p>
758 </div>
759 <hr>
760 <div class="refsect2">
761 <a name="json-object-get-int-member"></a><h3>json_object_get_int_member ()</h3>
762 <pre class="programlisting"><span class="returnvalue">gint64</span>              json_object_get_int_member          (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
763                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
764 <p>
765 Convenience function that retrieves the integer value
766 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em>
767 </p>
768 <p>
769 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
770 </p>
771 <div class="variablelist"><table border="0">
772 <col align="left" valign="top">
773 <tbody>
774 <tr>
775 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
776 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
777 </td>
778 </tr>
779 <tr>
780 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
781 <td>the name of the member</td>
782 </tr>
783 <tr>
784 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
785 <td>the integer value of the object's member</td>
786 </tr>
787 </tbody>
788 </table></div>
789 <p class="since">Since 0.8</p>
790 </div>
791 <hr>
792 <div class="refsect2">
793 <a name="json-object-set-null-member"></a><h3>json_object_set_null_member ()</h3>
794 <pre class="programlisting"><span class="returnvalue">void</span>                json_object_set_null_member         (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
795                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
796 <p>
797 Convenience function for setting a null <em class="parameter"><code>value</code></em> of
798 <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
799 </p>
800 <p>
801 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
802 </p>
803 <div class="variablelist"><table border="0">
804 <col align="left" valign="top">
805 <tbody>
806 <tr>
807 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
808 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
809 </td>
810 </tr>
811 <tr>
812 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
813 <td>the name of the member</td>
814 </tr>
815 </tbody>
816 </table></div>
817 <p class="since">Since 0.8</p>
818 </div>
819 <hr>
820 <div class="refsect2">
821 <a name="json-object-get-null-member"></a><h3>json_object_get_null_member ()</h3>
822 <pre class="programlisting"><span class="returnvalue">gboolean</span>            json_object_get_null_member         (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
823                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
824 <p>
825 Convenience function that checks whether the value
826 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em> is null
827 </p>
828 <p>
829 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
830 </p>
831 <div class="variablelist"><table border="0">
832 <col align="left" valign="top">
833 <tbody>
834 <tr>
835 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
836 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
837 </td>
838 </tr>
839 <tr>
840 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
841 <td>the name of the member</td>
842 </tr>
843 <tr>
844 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
845 <td>
846 <code class="literal">TRUE</code> if the value is null</td>
847 </tr>
848 </tbody>
849 </table></div>
850 <p class="since">Since 0.8</p>
851 </div>
852 <hr>
853 <div class="refsect2">
854 <a name="json-object-set-object-member"></a><h3>json_object_set_object_member ()</h3>
855 <pre class="programlisting"><span class="returnvalue">void</span>                json_object_set_object_member       (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
856                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
857                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *value</code></em>);</pre>
858 <p>
859 Convenience function for setting an object <em class="parameter"><code>value</code></em> of
860 <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
861 </p>
862 <p>
863 The <em class="parameter"><code>object</code></em> will take ownership of the passed <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
864 </p>
865 <p>
866 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
867 </p>
868 <div class="variablelist"><table border="0">
869 <col align="left" valign="top">
870 <tbody>
871 <tr>
872 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
873 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
874 </td>
875 </tr>
876 <tr>
877 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
878 <td>the name of the member</td>
879 </tr>
880 <tr>
881 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
882 <td>the value of the member. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
883 </td>
884 </tr>
885 </tbody>
886 </table></div>
887 <p class="since">Since 0.8</p>
888 </div>
889 <hr>
890 <div class="refsect2">
891 <a name="json-object-get-object-member"></a><h3>json_object_get_object_member ()</h3>
892 <pre class="programlisting"><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="returnvalue">JsonObject</span></a> *        json_object_get_object_member       (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
893                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
894 <p>
895 Convenience function that retrieves the object
896 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em>
897 </p>
898 <p>
899 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
900 </p>
901 <div class="variablelist"><table border="0">
902 <col align="left" valign="top">
903 <tbody>
904 <tr>
905 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
906 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
907 </td>
908 </tr>
909 <tr>
910 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
911 <td>the name of the member</td>
912 </tr>
913 <tr>
914 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
915 <td>the object inside the object's member. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
916 </td>
917 </tr>
918 </tbody>
919 </table></div>
920 <p class="since">Since 0.8</p>
921 </div>
922 <hr>
923 <div class="refsect2">
924 <a name="json-object-set-string-member"></a><h3>json_object_set_string_member ()</h3>
925 <pre class="programlisting"><span class="returnvalue">void</span>                json_object_set_string_member       (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
926                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
927                                                          <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
928 <p>
929 Convenience function for setting a string <em class="parameter"><code>value</code></em> of
930 <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
931 </p>
932 <p>
933 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
934 </p>
935 <div class="variablelist"><table border="0">
936 <col align="left" valign="top">
937 <tbody>
938 <tr>
939 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
940 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
941 </td>
942 </tr>
943 <tr>
944 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
945 <td>the name of the member</td>
946 </tr>
947 <tr>
948 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
949 <td>the value of the member</td>
950 </tr>
951 </tbody>
952 </table></div>
953 <p class="since">Since 0.8</p>
954 </div>
955 <hr>
956 <div class="refsect2">
957 <a name="json-object-get-string-member"></a><h3>json_object_get_string_member ()</h3>
958 <pre class="programlisting">const <span class="returnvalue">gchar</span> *       json_object_get_string_member       (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
959                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
960 <p>
961 Convenience function that retrieves the string value
962 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em>
963 </p>
964 <p>
965 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
966 </p>
967 <div class="variablelist"><table border="0">
968 <col align="left" valign="top">
969 <tbody>
970 <tr>
971 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
972 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
973 </td>
974 </tr>
975 <tr>
976 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
977 <td>the name of the member</td>
978 </tr>
979 <tr>
980 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
981 <td>the string value of the object's member</td>
982 </tr>
983 </tbody>
984 </table></div>
985 <p class="since">Since 0.8</p>
986 </div>
987 </div>
988 </div>
989 <div class="footer">
990 <hr>
991           Generated by GTK-Doc V1.18.1</div>
992 </body>
993 </html>