7921843e644fae748de4098c207e61df0e921f4c
[platform/upstream/json-glib.git] / doc / reference / html / JsonBuilder.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>JsonBuilder</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="ch03.html" title="Generator">
9 <link rel="prev" href="JsonGenerator.html" title="JsonGenerator">
10 <link rel="next" href="json-advanced.html" title="Part IV. JSON-GLib Advanced API">
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="JsonGenerator.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="ch03.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-advanced.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="#JsonBuilder.synopsis" class="shortcut">Top</a>
25                    | 
26                   <a href="#JsonBuilder.description" class="shortcut">Description</a>
27                    | 
28                   <a href="#JsonBuilder.object-hierarchy" class="shortcut">Object Hierarchy</a>
29 </td></tr>
30 </table>
31 <div class="refentry">
32 <a name="JsonBuilder"></a><div class="titlepage"></div>
33 <div class="refnamediv"><table width="100%"><tr>
34 <td valign="top">
35 <h2><span class="refentrytitle"><a name="JsonBuilder.top_of_page"></a>JsonBuilder</span></h2>
36 <p>JsonBuilder — Generates JSON trees</p>
37 </td>
38 <td valign="top" align="right"></td>
39 </tr></table></div>
40 <div class="refsynopsisdiv">
41 <a name="JsonBuilder.synopsis"></a><h2>Synopsis</h2>
42 <pre class="synopsis">struct              <a class="link" href="JsonBuilder.html#JsonBuilder-struct" title="struct JsonBuilder">JsonBuilder</a>;
43 struct              <a class="link" href="JsonBuilder.html#JsonBuilderClass" title="struct JsonBuilderClass">JsonBuilderClass</a>;
44 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       <a class="link" href="JsonBuilder.html#json-builder-new" title="json_builder_new ()">json_builder_new</a>                    (<em class="parameter"><code><span class="type">void</span></code></em>);
45 <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> *          <a class="link" href="JsonBuilder.html#json-builder-get-root" title="json_builder_get_root ()">json_builder_get_root</a>               (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);
46 <span class="returnvalue">void</span>                <a class="link" href="JsonBuilder.html#json-builder-reset" title="json_builder_reset ()">json_builder_reset</a>                  (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);
47
48 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       <a class="link" href="JsonBuilder.html#json-builder-begin-array" title="json_builder_begin_array ()">json_builder_begin_array</a>            (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);
49 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       <a class="link" href="JsonBuilder.html#json-builder-end-array" title="json_builder_end_array ()">json_builder_end_array</a>              (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);
50 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       <a class="link" href="JsonBuilder.html#json-builder-begin-object" title="json_builder_begin_object ()">json_builder_begin_object</a>           (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);
51 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       <a class="link" href="JsonBuilder.html#json-builder-set-member-name" title="json_builder_set_member_name ()">json_builder_set_member_name</a>        (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>,
52                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
53 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       <a class="link" href="JsonBuilder.html#json-builder-end-object" title="json_builder_end_object ()">json_builder_end_object</a>             (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);
54
55 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       <a class="link" href="JsonBuilder.html#json-builder-add-value" title="json_builder_add_value ()">json_builder_add_value</a>              (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>,
56                                                          <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>);
57 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       <a class="link" href="JsonBuilder.html#json-builder-add-int-value" title="json_builder_add_int_value ()">json_builder_add_int_value</a>          (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>,
58                                                          <em class="parameter"><code><span class="type">gint64</span> value</code></em>);
59 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       <a class="link" href="JsonBuilder.html#json-builder-add-double-value" title="json_builder_add_double_value ()">json_builder_add_double_value</a>       (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>,
60                                                          <em class="parameter"><code><span class="type">gdouble</span> value</code></em>);
61 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       <a class="link" href="JsonBuilder.html#json-builder-add-boolean-value" title="json_builder_add_boolean_value ()">json_builder_add_boolean_value</a>      (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>,
62                                                          <em class="parameter"><code><span class="type">gboolean</span> value</code></em>);
63 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       <a class="link" href="JsonBuilder.html#json-builder-add-string-value" title="json_builder_add_string_value ()">json_builder_add_string_value</a>       (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>,
64                                                          <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);
65 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       <a class="link" href="JsonBuilder.html#json-builder-add-null-value" title="json_builder_add_null_value ()">json_builder_add_null_value</a>         (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);
66 </pre>
67 </div>
68 <div class="refsect1">
69 <a name="JsonBuilder.object-hierarchy"></a><h2>Object Hierarchy</h2>
70 <pre class="synopsis">
71   GObject
72    +----JsonBuilder
73 </pre>
74 </div>
75 <div class="refsect1">
76 <a name="JsonBuilder.description"></a><h2>Description</h2>
77 <p>
78 <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> provides an object for generating a JSON tree.
79 You can generate only one tree with one <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> instance.
80 </p>
81 <p>
82 The root of the JSON tree can be either a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> or a <a class="link" href="json-glib-JSON-Array.html#JsonArray" title="JsonArray"><span class="type">JsonArray</span></a>.
83 Thus the first call must necessarily be either
84 <a class="link" href="JsonBuilder.html#json-builder-begin-object" title="json_builder_begin_object ()"><code class="function">json_builder_begin_object()</code></a> or <a class="link" href="JsonBuilder.html#json-builder-begin-array" title="json_builder_begin_array ()"><code class="function">json_builder_begin_array()</code></a>.
85 </p>
86 <p>
87 For convenience to language bindings, <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> returns itself from
88 most of functions, making it easy to chain function calls.
89 </p>
90 </div>
91 <div class="refsect1">
92 <a name="JsonBuilder.details"></a><h2>Details</h2>
93 <div class="refsect2">
94 <a name="JsonBuilder-struct"></a><h3>struct JsonBuilder</h3>
95 <pre class="programlisting">struct JsonBuilder;</pre>
96 <p>
97 The <span class="structname">JsonBuilder</span> structure contains only
98 private data and shouls be accessed using the provided API
99 </p>
100 <p class="since">Since 0.12</p>
101 </div>
102 <hr>
103 <div class="refsect2">
104 <a name="JsonBuilderClass"></a><h3>struct JsonBuilderClass</h3>
105 <pre class="programlisting">struct JsonBuilderClass {
106 };
107 </pre>
108 <p>
109 The <span class="structname">JsonBuilder</span> structure contains only
110 private data
111 </p>
112 <p class="since">Since 0.12</p>
113 </div>
114 <hr>
115 <div class="refsect2">
116 <a name="json-builder-new"></a><h3>json_builder_new ()</h3>
117 <pre class="programlisting"><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       json_builder_new                    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
118 <p>
119 Creates a new <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>. You can use this object to generate a
120 JSON tree and obtain the root <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a>s.
121 </p>
122 <div class="variablelist"><table border="0">
123 <col align="left" valign="top">
124 <tbody><tr>
125 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
126 <td>the newly created <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> instance</td>
127 </tr></tbody>
128 </table></div>
129 </div>
130 <hr>
131 <div class="refsect2">
132 <a name="json-builder-get-root"></a><h3>json_builder_get_root ()</h3>
133 <pre class="programlisting"><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> *          json_builder_get_root               (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);</pre>
134 <p>
135 Returns the root of the current constructed tree, if the build is complete
136 (ie: all opened objects, object members and arrays are being closed).
137 </p>
138 <div class="variablelist"><table border="0">
139 <col align="left" valign="top">
140 <tbody>
141 <tr>
142 <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
143 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
144 </td>
145 </tr>
146 <tr>
147 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
148 <td>the <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a>, or <code class="literal">NULL</code> if the build is not complete.
149 Free the returned value with <a class="link" href="json-glib-JSON-Node.html#json-node-free" title="json_node_free ()"><code class="function">json_node_free()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
150 </td>
151 </tr>
152 </tbody>
153 </table></div>
154 </div>
155 <hr>
156 <div class="refsect2">
157 <a name="json-builder-reset"></a><h3>json_builder_reset ()</h3>
158 <pre class="programlisting"><span class="returnvalue">void</span>                json_builder_reset                  (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);</pre>
159 <p>
160 Resets the state of the <em class="parameter"><code>builder</code></em> back to its initial state.
161 </p>
162 <div class="variablelist"><table border="0">
163 <col align="left" valign="top">
164 <tbody><tr>
165 <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
166 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
167 </td>
168 </tr></tbody>
169 </table></div>
170 </div>
171 <hr>
172 <div class="refsect2">
173 <a name="json-builder-begin-array"></a><h3>json_builder_begin_array ()</h3>
174 <pre class="programlisting"><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       json_builder_begin_array            (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);</pre>
175 <p>
176 Opens a subarray inside the given <em class="parameter"><code>builder</code></em>. When done adding members to
177 the subarray, <a class="link" href="JsonBuilder.html#json-builder-end-array" title="json_builder_end_array ()"><code class="function">json_builder_end_array()</code></a> must be called.
178 </p>
179 <p>
180 Can be called for first or only if the call is associated to an object member
181 or an array element.
182 </p>
183 <div class="variablelist"><table border="0">
184 <col align="left" valign="top">
185 <tbody>
186 <tr>
187 <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
188 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
189 </td>
190 </tr>
191 <tr>
192 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
193 <td>the <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>, or <code class="literal">NULL</code> if the call was inconsistent. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
194 </td>
195 </tr>
196 </tbody>
197 </table></div>
198 </div>
199 <hr>
200 <div class="refsect2">
201 <a name="json-builder-end-array"></a><h3>json_builder_end_array ()</h3>
202 <pre class="programlisting"><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       json_builder_end_array              (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);</pre>
203 <p>
204 Closes the subarray inside the given <em class="parameter"><code>builder</code></em> that was opened by the most
205 recent call to <a class="link" href="JsonBuilder.html#json-builder-begin-array" title="json_builder_begin_array ()"><code class="function">json_builder_begin_array()</code></a>.
206 </p>
207 <p>
208 Cannot be called after <a class="link" href="JsonBuilder.html#json-builder-set-member-name" title="json_builder_set_member_name ()"><code class="function">json_builder_set_member_name()</code></a>.
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>builder</code></em> :</span></p></td>
215 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
216 </td>
217 </tr>
218 <tr>
219 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
220 <td>the <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>, or <code class="literal">NULL</code> if the call was inconsistent. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
221 </td>
222 </tr>
223 </tbody>
224 </table></div>
225 </div>
226 <hr>
227 <div class="refsect2">
228 <a name="json-builder-begin-object"></a><h3>json_builder_begin_object ()</h3>
229 <pre class="programlisting"><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       json_builder_begin_object           (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);</pre>
230 <p>
231 Opens a subobject inside the given <em class="parameter"><code>builder</code></em>. When done adding members to
232 the subobject, <a class="link" href="JsonBuilder.html#json-builder-end-object" title="json_builder_end_object ()"><code class="function">json_builder_end_object()</code></a> must be called.
233 </p>
234 <p>
235 Can be called for first or only if the call is associated to an object member
236 or an array element.
237 </p>
238 <div class="variablelist"><table border="0">
239 <col align="left" valign="top">
240 <tbody>
241 <tr>
242 <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
243 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
244 </td>
245 </tr>
246 <tr>
247 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
248 <td>the <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>, or <code class="literal">NULL</code> if the call was inconsistent. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
249 </td>
250 </tr>
251 </tbody>
252 </table></div>
253 </div>
254 <hr>
255 <div class="refsect2">
256 <a name="json-builder-set-member-name"></a><h3>json_builder_set_member_name ()</h3>
257 <pre class="programlisting"><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       json_builder_set_member_name        (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>,
258                                                          <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
259 <p>
260 Set the name of the next member in an object. The next call must add a value,
261 open an object or an array.
262 </p>
263 <p>
264 Can be called only if the call is associated to an object.
265 </p>
266 <div class="variablelist"><table border="0">
267 <col align="left" valign="top">
268 <tbody>
269 <tr>
270 <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
271 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
272 </td>
273 </tr>
274 <tr>
275 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
276 <td>the name of the member</td>
277 </tr>
278 <tr>
279 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
280 <td>the <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>, or <code class="literal">NULL</code> if the call was inconsistent. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
281 </td>
282 </tr>
283 </tbody>
284 </table></div>
285 </div>
286 <hr>
287 <div class="refsect2">
288 <a name="json-builder-end-object"></a><h3>json_builder_end_object ()</h3>
289 <pre class="programlisting"><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       json_builder_end_object             (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);</pre>
290 <p>
291 Closes the subobject inside the given <em class="parameter"><code>builder</code></em> that was opened by the most
292 recent call to <a class="link" href="JsonBuilder.html#json-builder-begin-object" title="json_builder_begin_object ()"><code class="function">json_builder_begin_object()</code></a>.
293 </p>
294 <p>
295 Cannot be called after <a class="link" href="JsonBuilder.html#json-builder-set-member-name" title="json_builder_set_member_name ()"><code class="function">json_builder_set_member_name()</code></a>.
296 </p>
297 <div class="variablelist"><table border="0">
298 <col align="left" valign="top">
299 <tbody>
300 <tr>
301 <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
302 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
303 </td>
304 </tr>
305 <tr>
306 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
307 <td>the <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>, or <code class="literal">NULL</code> if the call was inconsistent. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
308 </td>
309 </tr>
310 </tbody>
311 </table></div>
312 </div>
313 <hr>
314 <div class="refsect2">
315 <a name="json-builder-add-value"></a><h3>json_builder_add_value ()</h3>
316 <pre class="programlisting"><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       json_builder_add_value              (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>,
317                                                          <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>
318 <p>
319 If called after <a class="link" href="JsonBuilder.html#json-builder-set-member-name" title="json_builder_set_member_name ()"><code class="function">json_builder_set_member_name()</code></a>, sets <em class="parameter"><code>node</code></em> as member of the
320 most recent opened object, otherwise <em class="parameter"><code>node</code></em> is added as element of the most
321 recent opened array.
322 </p>
323 <div class="variablelist"><table border="0">
324 <col align="left" valign="top">
325 <tbody>
326 <tr>
327 <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
328 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
329 </td>
330 </tr>
331 <tr>
332 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
333 <td>the value of the member or element</td>
334 </tr>
335 <tr>
336 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
337 <td>the <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>, or <code class="literal">NULL</code> if the call was inconsistent. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
338 </td>
339 </tr>
340 </tbody>
341 </table></div>
342 </div>
343 <hr>
344 <div class="refsect2">
345 <a name="json-builder-add-int-value"></a><h3>json_builder_add_int_value ()</h3>
346 <pre class="programlisting"><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       json_builder_add_int_value          (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>,
347                                                          <em class="parameter"><code><span class="type">gint64</span> value</code></em>);</pre>
348 <p>
349 If called after <a class="link" href="JsonBuilder.html#json-builder-set-member-name" title="json_builder_set_member_name ()"><code class="function">json_builder_set_member_name()</code></a>, sets <em class="parameter"><code>value</code></em> as member of the
350 most recent opened object, otherwise <em class="parameter"><code>value</code></em> is added as element of the most
351 recent opened array.
352 </p>
353 <p>
354 See also: <a class="link" href="JsonBuilder.html#json-builder-add-value" title="json_builder_add_value ()"><code class="function">json_builder_add_value()</code></a>
355 </p>
356 <div class="variablelist"><table border="0">
357 <col align="left" valign="top">
358 <tbody>
359 <tr>
360 <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
361 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
362 </td>
363 </tr>
364 <tr>
365 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
366 <td>the value of the member or element</td>
367 </tr>
368 <tr>
369 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
370 <td>the <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>, or <code class="literal">NULL</code> if the call was inconsistent. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
371 </td>
372 </tr>
373 </tbody>
374 </table></div>
375 </div>
376 <hr>
377 <div class="refsect2">
378 <a name="json-builder-add-double-value"></a><h3>json_builder_add_double_value ()</h3>
379 <pre class="programlisting"><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       json_builder_add_double_value       (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>,
380                                                          <em class="parameter"><code><span class="type">gdouble</span> value</code></em>);</pre>
381 <p>
382 If called after <a class="link" href="JsonBuilder.html#json-builder-set-member-name" title="json_builder_set_member_name ()"><code class="function">json_builder_set_member_name()</code></a>, sets <em class="parameter"><code>value</code></em> as member of the
383 most recent opened object, otherwise <em class="parameter"><code>value</code></em> is added as element of the most
384 recent opened array.
385 </p>
386 <p>
387 See also: <a class="link" href="JsonBuilder.html#json-builder-add-value" title="json_builder_add_value ()"><code class="function">json_builder_add_value()</code></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>builder</code></em> :</span></p></td>
394 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
395 </td>
396 </tr>
397 <tr>
398 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
399 <td>the value of the member or element</td>
400 </tr>
401 <tr>
402 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
403 <td>the <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>, or <code class="literal">NULL</code> if the call was inconsistent. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
404 </td>
405 </tr>
406 </tbody>
407 </table></div>
408 </div>
409 <hr>
410 <div class="refsect2">
411 <a name="json-builder-add-boolean-value"></a><h3>json_builder_add_boolean_value ()</h3>
412 <pre class="programlisting"><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       json_builder_add_boolean_value      (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>,
413                                                          <em class="parameter"><code><span class="type">gboolean</span> value</code></em>);</pre>
414 <p>
415 If called after <a class="link" href="JsonBuilder.html#json-builder-set-member-name" title="json_builder_set_member_name ()"><code class="function">json_builder_set_member_name()</code></a>, sets <em class="parameter"><code>value</code></em> as member of the
416 most recent opened object, otherwise <em class="parameter"><code>value</code></em> is added as element of the most
417 recent opened array.
418 </p>
419 <p>
420 See also: <a class="link" href="JsonBuilder.html#json-builder-add-value" title="json_builder_add_value ()"><code class="function">json_builder_add_value()</code></a>
421 </p>
422 <div class="variablelist"><table border="0">
423 <col align="left" valign="top">
424 <tbody>
425 <tr>
426 <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
427 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
428 </td>
429 </tr>
430 <tr>
431 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
432 <td>the value of the member or element</td>
433 </tr>
434 <tr>
435 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
436 <td>the <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>, or <code class="literal">NULL</code> if the call was inconsistent. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
437 </td>
438 </tr>
439 </tbody>
440 </table></div>
441 </div>
442 <hr>
443 <div class="refsect2">
444 <a name="json-builder-add-string-value"></a><h3>json_builder_add_string_value ()</h3>
445 <pre class="programlisting"><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       json_builder_add_string_value       (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>,
446                                                          <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
447 <p>
448 If called after <a class="link" href="JsonBuilder.html#json-builder-set-member-name" title="json_builder_set_member_name ()"><code class="function">json_builder_set_member_name()</code></a>, sets <em class="parameter"><code>value</code></em> as member of the
449 most recent opened object, otherwise <em class="parameter"><code>value</code></em> is added as element of the most
450 recent opened array.
451 </p>
452 <p>
453 See also: <a class="link" href="JsonBuilder.html#json-builder-add-value" title="json_builder_add_value ()"><code class="function">json_builder_add_value()</code></a>
454 </p>
455 <div class="variablelist"><table border="0">
456 <col align="left" valign="top">
457 <tbody>
458 <tr>
459 <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
460 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
461 </td>
462 </tr>
463 <tr>
464 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
465 <td>the value of the member or element</td>
466 </tr>
467 <tr>
468 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
469 <td>the <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>, or <code class="literal">NULL</code> if the call was inconsistent. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
470 </td>
471 </tr>
472 </tbody>
473 </table></div>
474 </div>
475 <hr>
476 <div class="refsect2">
477 <a name="json-builder-add-null-value"></a><h3>json_builder_add_null_value ()</h3>
478 <pre class="programlisting"><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="returnvalue">JsonBuilder</span></a> *       json_builder_add_null_value         (<em class="parameter"><code><a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a> *builder</code></em>);</pre>
479 <p>
480 If called after <a class="link" href="JsonBuilder.html#json-builder-set-member-name" title="json_builder_set_member_name ()"><code class="function">json_builder_set_member_name()</code></a>, sets null as member of the
481 most recent opened object, otherwise null is added as element of the most
482 recent opened array.
483 </p>
484 <p>
485 See also: <a class="link" href="JsonBuilder.html#json-builder-add-value" title="json_builder_add_value ()"><code class="function">json_builder_add_value()</code></a>
486 </p>
487 <div class="variablelist"><table border="0">
488 <col align="left" valign="top">
489 <tbody>
490 <tr>
491 <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
492 <td>a <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>
493 </td>
494 </tr>
495 <tr>
496 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
497 <td>the <a class="link" href="JsonBuilder.html" title="JsonBuilder"><span class="type">JsonBuilder</span></a>, or <code class="literal">NULL</code> if the call was inconsistent. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
498 </td>
499 </tr>
500 </tbody>
501 </table></div>
502 </div>
503 </div>
504 <div class="refsect1">
505 <a name="JsonBuilder.see-also"></a><h2>See Also</h2>
506 JsonGenerator
507 </div>
508 </div>
509 <div class="footer">
510 <hr>
511           Generated by GTK-Doc V1.18.1</div>
512 </body>
513 </html>