doc/reference/html/json-glib-JSON-Array.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 Array: JSON-GLib Reference Manual</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.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-Node.html" title="JSON Node">
  10 <link rel="next" href="json-glib-JSON-Object.html" title="JSON Object">
  11 <meta name="generator" content="GTK-Doc V1.25.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="5"><tr valign="middle">
  16 <td width="100%" align="left" class="shortcuts">
  17 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span>
  18                   <a href="#json-glib-JSON-Array.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span>
  19                   <a href="#json-glib-JSON-Array.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
  20 </td>
  21 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
  22 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
  23 <td><a accesskey="p" href="json-glib-JSON-Node.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
  24 <td><a accesskey="n" href="json-glib-JSON-Object.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
  25 </tr></table>
  26 <div class="refentry">
  27 <a name="json-glib-JSON-Array"></a><div class="titlepage"></div>
  28 <div class="refnamediv"><table width="100%"><tr>
  29 <td valign="top">
  30 <h2><span class="refentrytitle"><a name="json-glib-JSON-Array.top_of_page"></a>JSON Array</span></h2>
  31 <p>JSON Array — a JSON array representation</p>
  32 </td>
  33 <td class="gallery_image" valign="top" align="right"></td>
  34 </tr></table></div>
  35 <div class="refsect1">
  36 <a name="json-glib-JSON-Array.functions"></a><h2>Functions</h2>
  37 <div class="informaltable"><table class="informaltable" width="100%" border="0">
  38 <colgroup>
  39 <col width="150px" class="functions_return">
  40 <col class="functions_name">
  41 </colgroup>
  42 <tbody>
  43 <tr>
  44 <td class="function_type">
  45 <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="returnvalue">JsonArray</span></a> *
  46 </td>
  47 <td class="function_name">
  48 <a class="link" href="json-glib-JSON-Array.html#json-array-new" title="json_array_new ()">json_array_new</a> <span class="c_punctuation">()</span>
  49 </td>
  50 </tr>
  51 <tr>
  52 <td class="function_type">
  53 <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="returnvalue">JsonArray</span></a> *
  54 </td>
  55 <td class="function_name">
  56 <a class="link" href="json-glib-JSON-Array.html#json-array-sized-new" title="json_array_sized_new ()">json_array_sized_new</a> <span class="c_punctuation">()</span>
  57 </td>
  58 </tr>
  59 <tr>
  60 <td class="function_type">
  61 <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="returnvalue">JsonArray</span></a> *
  62 </td>
  63 <td class="function_name">
  64 <a class="link" href="json-glib-JSON-Array.html#json-array-ref" title="json_array_ref ()">json_array_ref</a> <span class="c_punctuation">()</span>
  65 </td>
  66 </tr>
  67 <tr>
  68 <td class="function_type">
  69 <span class="returnvalue">void</span>
  70 </td>
  71 <td class="function_name">
  72 <a class="link" href="json-glib-JSON-Array.html#json-array-unref" title="json_array_unref ()">json_array_unref</a> <span class="c_punctuation">()</span>
  73 </td>
  74 </tr>
  75 <tr>
  76 <td class="function_type">
  77 <span class="returnvalue">void</span>
  78 </td>
  79 <td class="function_name">
  80 <a class="link" href="json-glib-JSON-Array.html#json-array-seal" title="json_array_seal ()">json_array_seal</a> <span class="c_punctuation">()</span>
  81 </td>
  82 </tr>
  83 <tr>
  84 <td class="function_type">
  85 <span class="returnvalue">gboolean</span>
  86 </td>
  87 <td class="function_name">
  88 <a class="link" href="json-glib-JSON-Array.html#json-array-is-immutable" title="json_array_is_immutable ()">json_array_is_immutable</a> <span class="c_punctuation">()</span>
  89 </td>
  90 </tr>
  91 <tr>
  92 <td class="function_type">
  93 <span class="returnvalue">guint</span>
  94 </td>
  95 <td class="function_name">
  96 <a class="link" href="json-glib-JSON-Array.html#json-array-hash" title="json_array_hash ()">json_array_hash</a> <span class="c_punctuation">()</span>
  97 </td>
  98 </tr>
  99 <tr>
 100 <td class="function_type">
 101 <span class="returnvalue">gboolean</span>
 102 </td>
 103 <td class="function_name">
 104 <a class="link" href="json-glib-JSON-Array.html#json-array-equal" title="json_array_equal ()">json_array_equal</a> <span class="c_punctuation">()</span>
 105 </td>
 106 </tr>
 107 <tr>
 108 <td class="function_type">
 109 <span class="returnvalue">void</span>
 110 </td>
 111 <td class="function_name">
 112 <a class="link" href="json-glib-JSON-Array.html#json-array-add-element" title="json_array_add_element ()">json_array_add_element</a> <span class="c_punctuation">()</span>
 113 </td>
 114 </tr>
 115 <tr>
 116 <td class="function_type">
 117 <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="returnvalue">JsonNode</span></a> *
 118 </td>
 119 <td class="function_name">
 120 <a class="link" href="json-glib-JSON-Array.html#json-array-get-element" title="json_array_get_element ()">json_array_get_element</a> <span class="c_punctuation">()</span>
 121 </td>
 122 </tr>
 123 <tr>
 124 <td class="function_type">
 125 <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="returnvalue">JsonNode</span></a> *
 126 </td>
 127 <td class="function_name">
 128 <a class="link" href="json-glib-JSON-Array.html#json-array-dup-element" title="json_array_dup_element ()">json_array_dup_element</a> <span class="c_punctuation">()</span>
 129 </td>
 130 </tr>
 131 <tr>
 132 <td class="function_type">
 133 <span class="returnvalue">GList</span> *
 134 </td>
 135 <td class="function_name">
 136 <a class="link" href="json-glib-JSON-Array.html#json-array-get-elements" title="json_array_get_elements ()">json_array_get_elements</a> <span class="c_punctuation">()</span>
 137 </td>
 138 </tr>
 139 <tr>
 140 <td class="function_type">
 141 <span class="returnvalue">guint</span>
 142 </td>
 143 <td class="function_name">
 144 <a class="link" href="json-glib-JSON-Array.html#json-array-get-length" title="json_array_get_length ()">json_array_get_length</a> <span class="c_punctuation">()</span>
 145 </td>
 146 </tr>
 147 <tr>
 148 <td class="function_type">
 149 <span class="returnvalue">void</span>
 150 </td>
 151 <td class="function_name">
 152 <a class="link" href="json-glib-JSON-Array.html#json-array-remove-element" title="json_array_remove_element ()">json_array_remove_element</a> <span class="c_punctuation">()</span>
 153 </td>
 154 </tr>
 155 <tr>
 156 <td class="function_type">
 157 <span class="returnvalue">void</span>
 158 </td>
 159 <td class="function_name">
 160 <span class="c_punctuation">(</span><a class="link" href="json-glib-JSON-Array.html#JsonArrayForeach" title="JsonArrayForeach ()">*JsonArrayForeach</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
 161 </td>
 162 </tr>
 163 <tr>
 164 <td class="function_type">
 165 <span class="returnvalue">void</span>
 166 </td>
 167 <td class="function_name">
 168 <a class="link" href="json-glib-JSON-Array.html#json-array-foreach-element" title="json_array_foreach_element ()">json_array_foreach_element</a> <span class="c_punctuation">()</span>
 169 </td>
 170 </tr>
 171 <tr>
 172 <td class="function_type">
 173 <span class="returnvalue">void</span>
 174 </td>
 175 <td class="function_name">
 176 <a class="link" href="json-glib-JSON-Array.html#json-array-add-array-element" title="json_array_add_array_element ()">json_array_add_array_element</a> <span class="c_punctuation">()</span>
 177 </td>
 178 </tr>
 179 <tr>
 180 <td class="function_type">
 181 <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="returnvalue">JsonArray</span></a> *
 182 </td>
 183 <td class="function_name">
 184 <a class="link" href="json-glib-JSON-Array.html#json-array-get-array-element" title="json_array_get_array_element ()">json_array_get_array_element</a> <span class="c_punctuation">()</span>
 185 </td>
 186 </tr>
 187 <tr>
 188 <td class="function_type">
 189 <span class="returnvalue">void</span>
 190 </td>
 191 <td class="function_name">
 192 <a class="link" href="json-glib-JSON-Array.html#json-array-add-boolean-element" title="json_array_add_boolean_element ()">json_array_add_boolean_element</a> <span class="c_punctuation">()</span>
 193 </td>
 194 </tr>
 195 <tr>
 196 <td class="function_type">
 197 <span class="returnvalue">gboolean</span>
 198 </td>
 199 <td class="function_name">
 200 <a class="link" href="json-glib-JSON-Array.html#json-array-get-boolean-element" title="json_array_get_boolean_element ()">json_array_get_boolean_element</a> <span class="c_punctuation">()</span>
 201 </td>
 202 </tr>
 203 <tr>
 204 <td class="function_type">
 205 <span class="returnvalue">void</span>
 206 </td>
 207 <td class="function_name">
 208 <a class="link" href="json-glib-JSON-Array.html#json-array-add-double-element" title="json_array_add_double_element ()">json_array_add_double_element</a> <span class="c_punctuation">()</span>
 209 </td>
 210 </tr>
 211 <tr>
 212 <td class="function_type">
 213 <span class="returnvalue">gdouble</span>
 214 </td>
 215 <td class="function_name">
 216 <a class="link" href="json-glib-JSON-Array.html#json-array-get-double-element" title="json_array_get_double_element ()">json_array_get_double_element</a> <span class="c_punctuation">()</span>
 217 </td>
 218 </tr>
 219 <tr>
 220 <td class="function_type">
 221 <span class="returnvalue">void</span>
 222 </td>
 223 <td class="function_name">
 224 <a class="link" href="json-glib-JSON-Array.html#json-array-add-int-element" title="json_array_add_int_element ()">json_array_add_int_element</a> <span class="c_punctuation">()</span>
 225 </td>
 226 </tr>
 227 <tr>
 228 <td class="function_type">
 229 <span class="returnvalue">gint64</span>
 230 </td>
 231 <td class="function_name">
 232 <a class="link" href="json-glib-JSON-Array.html#json-array-get-int-element" title="json_array_get_int_element ()">json_array_get_int_element</a> <span class="c_punctuation">()</span>
 233 </td>
 234 </tr>
 235 <tr>
 236 <td class="function_type">
 237 <span class="returnvalue">void</span>
 238 </td>
 239 <td class="function_name">
 240 <a class="link" href="json-glib-JSON-Array.html#json-array-add-null-element" title="json_array_add_null_element ()">json_array_add_null_element</a> <span class="c_punctuation">()</span>
 241 </td>
 242 </tr>
 243 <tr>
 244 <td class="function_type">
 245 <span class="returnvalue">gboolean</span>
 246 </td>
 247 <td class="function_name">
 248 <a class="link" href="json-glib-JSON-Array.html#json-array-get-null-element" title="json_array_get_null_element ()">json_array_get_null_element</a> <span class="c_punctuation">()</span>
 249 </td>
 250 </tr>
 251 <tr>
 252 <td class="function_type">
 253 <span class="returnvalue">void</span>
 254 </td>
 255 <td class="function_name">
 256 <a class="link" href="json-glib-JSON-Array.html#json-array-add-object-element" title="json_array_add_object_element ()">json_array_add_object_element</a> <span class="c_punctuation">()</span>
 257 </td>
 258 </tr>
 259 <tr>
 260 <td class="function_type">
 261 <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="returnvalue">JsonObject</span></a> *
 262 </td>
 263 <td class="function_name">
 264 <a class="link" href="json-glib-JSON-Array.html#json-array-get-object-element" title="json_array_get_object_element ()">json_array_get_object_element</a> <span class="c_punctuation">()</span>
 265 </td>
 266 </tr>
 267 <tr>
 268 <td class="function_type">
 269 <span class="returnvalue">void</span>
 270 </td>
 271 <td class="function_name">
 272 <a class="link" href="json-glib-JSON-Array.html#json-array-add-string-element" title="json_array_add_string_element ()">json_array_add_string_element</a> <span class="c_punctuation">()</span>
 273 </td>
 274 </tr>
 275 <tr>
 276 <td class="function_type">const <span class="returnvalue">gchar</span> *
 277 </td>
 278 <td class="function_name">
 279 <a class="link" href="json-glib-JSON-Array.html#json-array-get-string-element" title="json_array_get_string_element ()">json_array_get_string_element</a> <span class="c_punctuation">()</span>
 280 </td>
 281 </tr>
 282 </tbody>
 283 </table></div>
 284 </div>
 285 <a name="JsonArray"></a><div class="refsect1">
 286 <a name="json-glib-JSON-Array.other"></a><h2>Types and Values</h2>
 287 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 288 <colgroup>
 289 <col width="150px" class="name">
 290 <col class="description">
 291 </colgroup>
 292 <tbody><tr>
 293 <td class="datatype_keyword"> </td>
 294 <td class="function_name"><a class="link" href="json-glib-JSON-Array.html#JsonArray-struct" title="JsonArray">JsonArray</a></td>
 295 </tr></tbody>
 296 </table></div>
 297 </div>
 298 <div class="refsect1">
 299 <a name="json-glib-JSON-Array.object-hierarchy"></a><h2>Object Hierarchy</h2>
 300 <pre class="screen">    <a href="/home/ebassi/gnome/install/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a>
 301     <span class="lineart">╰──</span> JsonArray
 302 </pre>
 303 </div>
 304 <div class="refsect1">
 305 <a name="json-glib-JSON-Array.description"></a><h2>Description</h2>
 306 <p><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> is the representation of the array type inside JSON. It contains
 307 <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> elements, which may contain fundamental types, other arrays or
 308 objects.</p>
 309 <p>Since arrays can be expensive, they are reference counted. You can control
 310 the lifetime of a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> using <a class="link" href="json-glib-JSON-Array.html#json-array-ref" title="json_array_ref ()"><code class="function">json_array_ref()</code></a> and <a class="link" href="json-glib-JSON-Array.html#json-array-unref" title="json_array_unref ()"><code class="function">json_array_unref()</code></a>.</p>
 311 <p>To append an element, use <a class="link" href="json-glib-JSON-Array.html#json-array-add-element" title="json_array_add_element ()"><code class="function">json_array_add_element()</code></a>.
 312 To extract an element at a given index, use <a class="link" href="json-glib-JSON-Array.html#json-array-get-element" title="json_array_get_element ()"><code class="function">json_array_get_element()</code></a>.
 313 To retrieve the entire array in list form, use <a class="link" href="json-glib-JSON-Array.html#json-array-get-elements" title="json_array_get_elements ()"><code class="function">json_array_get_elements()</code></a>.
 314 To retrieve the length of the array, use <a class="link" href="json-glib-JSON-Array.html#json-array-get-length" title="json_array_get_length ()"><code class="function">json_array_get_length()</code></a>.</p>
 315 </div>
 316 <div class="refsect1">
 317 <a name="json-glib-JSON-Array.functions_details"></a><h2>Functions</h2>
 318 <div class="refsect2">
 319 <a name="json-array-new"></a><h3>json_array_new ()</h3>
 320 <pre class="programlisting"><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="returnvalue">JsonArray</span></a> *
 321 json_array_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 322 <p>Creates a new <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a>.</p>
 323 <p><span class="annotation">[<acronym title="This symbol is a constructor, not a static method."><span class="acronym">constructor</span></acronym>]</span></p>
 324 <div class="refsect3">
 325 <a name="json-array-new.returns"></a><h4>Returns</h4>
 326 <p> the newly created <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a>. </p>
 327 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 328 </div>
 329 </div>
 330 <hr>
 331 <div class="refsect2">
 332 <a name="json-array-sized-new"></a><h3>json_array_sized_new ()</h3>
 333 <pre class="programlisting"><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="returnvalue">JsonArray</span></a> *
 334 json_array_sized_new (<em class="parameter"><code><span class="type">guint</span> n_elements</code></em>);</pre>
 335 <p>Creates a new <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> with <em class="parameter"><code>n_elements</code></em>
 336  slots already allocated.</p>
 337 <p><span class="annotation">[<acronym title="This symbol is a constructor, not a static method."><span class="acronym">constructor</span></acronym>]</span></p>
 338 <div class="refsect3">
 339 <a name="json-array-sized-new.parameters"></a><h4>Parameters</h4>
 340 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 341 <colgroup>
 342 <col width="150px" class="parameters_name">
 343 <col class="parameters_description">
 344 <col width="200px" class="parameters_annotations">
 345 </colgroup>
 346 <tbody><tr>
 347 <td class="parameter_name"><p>n_elements</p></td>
 348 <td class="parameter_description"><p>number of slots to pre-allocate</p></td>
 349 <td class="parameter_annotations"> </td>
 350 </tr></tbody>
 351 </table></div>
 352 </div>
 353 <div class="refsect3">
 354 <a name="json-array-sized-new.returns"></a><h4>Returns</h4>
 355 <p> the newly created <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a>. </p>
 356 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 357 </div>
 358 </div>
 359 <hr>
 360 <div class="refsect2">
 361 <a name="json-array-ref"></a><h3>json_array_ref ()</h3>
 362 <pre class="programlisting"><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="returnvalue">JsonArray</span></a> *
 363 json_array_ref (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>);</pre>
 364 <p>Increase by one the reference count of a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a>.</p>
 365 <div class="refsect3">
 366 <a name="json-array-ref.parameters"></a><h4>Parameters</h4>
 367 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 368 <colgroup>
 369 <col width="150px" class="parameters_name">
 370 <col class="parameters_description">
 371 <col width="200px" class="parameters_annotations">
 372 </colgroup>
 373 <tbody><tr>
 374 <td class="parameter_name"><p>array</p></td>
 375 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 376 <td class="parameter_annotations"> </td>
 377 </tr></tbody>
 378 </table></div>
 379 </div>
 380 <div class="refsect3">
 381 <a name="json-array-ref.returns"></a><h4>Returns</h4>
 382 <p> the passed <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a>, with the reference count
 383 increased by one. </p>
 384 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 385 </div>
 386 </div>
 387 <hr>
 388 <div class="refsect2">
 389 <a name="json-array-unref"></a><h3>json_array_unref ()</h3>
 390 <pre class="programlisting"><span class="returnvalue">void</span>
 391 json_array_unref (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>);</pre>
 392 <p>Decreases by one the reference count of a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a>. If the
 393 reference count reaches zero, the array is destroyed and all
 394 its allocated resources are freed.</p>
 395 <div class="refsect3">
 396 <a name="json-array-unref.parameters"></a><h4>Parameters</h4>
 397 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 398 <colgroup>
 399 <col width="150px" class="parameters_name">
 400 <col class="parameters_description">
 401 <col width="200px" class="parameters_annotations">
 402 </colgroup>
 403 <tbody><tr>
 404 <td class="parameter_name"><p>array</p></td>
 405 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 406 <td class="parameter_annotations"> </td>
 407 </tr></tbody>
 408 </table></div>
 409 </div>
 410 </div>
 411 <hr>
 412 <div class="refsect2">
 413 <a name="json-array-seal"></a><h3>json_array_seal ()</h3>
 414 <pre class="programlisting"><span class="returnvalue">void</span>
 415 json_array_seal (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>);</pre>
 416 <p>Seals the <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a>, making it immutable to further changes. This will
 417 recursively seal all elements in the array too.</p>
 418 <p>If the <em class="parameter"><code>array</code></em>
 419  is already immutable, this is a no-op.</p>
 420 <div class="refsect3">
 421 <a name="json-array-seal.parameters"></a><h4>Parameters</h4>
 422 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 423 <colgroup>
 424 <col width="150px" class="parameters_name">
 425 <col class="parameters_description">
 426 <col width="200px" class="parameters_annotations">
 427 </colgroup>
 428 <tbody><tr>
 429 <td class="parameter_name"><p>array</p></td>
 430 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 431 <td class="parameter_annotations"> </td>
 432 </tr></tbody>
 433 </table></div>
 434 </div>
 435 <p class="since">Since: <a class="link" href="ix11.html#api-index-1.2">1.2</a></p>
 436 </div>
 437 <hr>
 438 <div class="refsect2">
 439 <a name="json-array-is-immutable"></a><h3>json_array_is_immutable ()</h3>
 440 <pre class="programlisting"><span class="returnvalue">gboolean</span>
 441 json_array_is_immutable (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>);</pre>
 442 <p>Check whether the given <em class="parameter"><code>array</code></em>
 443  has been marked as immutable by calling
 444 <a class="link" href="json-glib-JSON-Array.html#json-array-seal" title="json_array_seal ()"><code class="function">json_array_seal()</code></a> on it.</p>
 445 <div class="refsect3">
 446 <a name="json-array-is-immutable.parameters"></a><h4>Parameters</h4>
 447 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 448 <colgroup>
 449 <col width="150px" class="parameters_name">
 450 <col class="parameters_description">
 451 <col width="200px" class="parameters_annotations">
 452 </colgroup>
 453 <tbody><tr>
 454 <td class="parameter_name"><p>array</p></td>
 455 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 456 <td class="parameter_annotations"> </td>
 457 </tr></tbody>
 458 </table></div>
 459 </div>
 460 <div class="refsect3">
 461 <a name="json-array-is-immutable.returns"></a><h4>Returns</h4>
 462 <p> <code class="literal">TRUE</code> if the <em class="parameter"><code>array</code></em>
 463 is immutable</p>
 464 </div>
 465 <p class="since">Since: <a class="link" href="ix11.html#api-index-1.2">1.2</a></p>
 466 </div>
 467 <hr>
 468 <div class="refsect2">
 469 <a name="json-array-hash"></a><h3>json_array_hash ()</h3>
 470 <pre class="programlisting"><span class="returnvalue">guint</span>
 471 json_array_hash (<em class="parameter"><code><span class="type">gconstpointer</span> key</code></em>);</pre>
 472 <p>Calculate a hash value for the given <em class="parameter"><code>key</code></em>
 473  (a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a>).</p>
 474 <p>The hash is calculated over the array and all its elements, recursively. If
 475 the array is immutable, this is a fast operation; otherwise, it scales
 476 proportionally with the length of the array.</p>
 477 <div class="refsect3">
 478 <a name="json-array-hash.parameters"></a><h4>Parameters</h4>
 479 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 480 <colgroup>
 481 <col width="150px" class="parameters_name">
 482 <col class="parameters_description">
 483 <col width="200px" class="parameters_annotations">
 484 </colgroup>
 485 <tbody><tr>
 486 <td class="parameter_name"><p>key</p></td>
 487 <td class="parameter_description"><p> a JSON array to hash. </p></td>
 488 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> JsonArray]</span></td>
 489 </tr></tbody>
 490 </table></div>
 491 </div>
 492 <div class="refsect3">
 493 <a name="json-array-hash.returns"></a><h4>Returns</h4>
 494 <p> hash value for <em class="parameter"><code>key</code></em>
 495 </p>
 496 </div>
 497 <p class="since">Since: <a class="link" href="ix11.html#api-index-1.2">1.2</a></p>
 498 </div>
 499 <hr>
 500 <div class="refsect2">
 501 <a name="json-array-equal"></a><h3>json_array_equal ()</h3>
 502 <pre class="programlisting"><span class="returnvalue">gboolean</span>
 503 json_array_equal (<em class="parameter"><code><span class="type">gconstpointer</span> a</code></em>,
 504                   <em class="parameter"><code><span class="type">gconstpointer</span> b</code></em>);</pre>
 505 <p>Check whether <em class="parameter"><code>a</code></em>
 506  and <em class="parameter"><code>b</code></em>
 507  are equal <a href="json-glib-JSON-Array.html#JsonArray-struct"><span class="type">JsonArrays</span></a>, meaning they have the same
 508 number of elements, and the values of elements in corresponding positions
 509 are equal.</p>
 510 <div class="refsect3">
 511 <a name="json-array-equal.parameters"></a><h4>Parameters</h4>
 512 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 513 <colgroup>
 514 <col width="150px" class="parameters_name">
 515 <col class="parameters_description">
 516 <col width="200px" class="parameters_annotations">
 517 </colgroup>
 518 <tbody>
 519 <tr>
 520 <td class="parameter_name"><p>a</p></td>
 521 <td class="parameter_description"><p> a JSON array. </p></td>
 522 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> JsonArray]</span></td>
 523 </tr>
 524 <tr>
 525 <td class="parameter_name"><p>b</p></td>
 526 <td class="parameter_description"><p> another JSON array. </p></td>
 527 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> JsonArray]</span></td>
 528 </tr>
 529 </tbody>
 530 </table></div>
 531 </div>
 532 <div class="refsect3">
 533 <a name="json-array-equal.returns"></a><h4>Returns</h4>
 534 <p> <code class="literal">TRUE</code> if <em class="parameter"><code>a</code></em>
 535 and <em class="parameter"><code>b</code></em>
 536 are equal; <code class="literal">FALSE</code> otherwise</p>
 537 </div>
 538 <p class="since">Since: <a class="link" href="ix11.html#api-index-1.2">1.2</a></p>
 539 </div>
 540 <hr>
 541 <div class="refsect2">
 542 <a name="json-array-add-element"></a><h3>json_array_add_element ()</h3>
 543 <pre class="programlisting"><span class="returnvalue">void</span>
 544 json_array_add_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
 545                         <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
 546 <p>Appends <em class="parameter"><code>node</code></em>
 547  inside <em class="parameter"><code>array</code></em>
 548 . The array will take ownership of the
 549 <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a>.</p>
 550 <div class="refsect3">
 551 <a name="json-array-add-element.parameters"></a><h4>Parameters</h4>
 552 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 553 <colgroup>
 554 <col width="150px" class="parameters_name">
 555 <col class="parameters_description">
 556 <col width="200px" class="parameters_annotations">
 557 </colgroup>
 558 <tbody>
 559 <tr>
 560 <td class="parameter_name"><p>array</p></td>
 561 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 562 <td class="parameter_annotations"> </td>
 563 </tr>
 564 <tr>
 565 <td class="parameter_name"><p>node</p></td>
 566 <td class="parameter_description"><p> a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a>. </p></td>
 567 <td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
 568 </tr>
 569 </tbody>
 570 </table></div>
 571 </div>
 572 </div>
 573 <hr>
 574 <div class="refsect2">
 575 <a name="json-array-get-element"></a><h3>json_array_get_element ()</h3>
 576 <pre class="programlisting"><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="returnvalue">JsonNode</span></a> *
 577 json_array_get_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
 578                         <em class="parameter"><code><span class="type">guint</span> index_</code></em>);</pre>
 579 <p>Retrieves the <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> containing the value of the element at <em class="parameter"><code>index_</code></em>
 580
 581 inside a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a>.</p>
 582 <div class="refsect3">
 583 <a name="json-array-get-element.parameters"></a><h4>Parameters</h4>
 584 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 585 <colgroup>
 586 <col width="150px" class="parameters_name">
 587 <col class="parameters_description">
 588 <col width="200px" class="parameters_annotations">
 589 </colgroup>
 590 <tbody>
 591 <tr>
 592 <td class="parameter_name"><p>array</p></td>
 593 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 594 <td class="parameter_annotations"> </td>
 595 </tr>
 596 <tr>
 597 <td class="parameter_name"><p>index_</p></td>
 598 <td class="parameter_description"><p>the index of the element to retrieve</p></td>
 599 <td class="parameter_annotations"> </td>
 600 </tr>
 601 </tbody>
 602 </table></div>
 603 </div>
 604 <div class="refsect3">
 605 <a name="json-array-get-element.returns"></a><h4>Returns</h4>
 606 <p> a pointer to the <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> at the requested index. </p>
 607 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 608 </div>
 609 </div>
 610 <hr>
 611 <div class="refsect2">
 612 <a name="json-array-dup-element"></a><h3>json_array_dup_element ()</h3>
 613 <pre class="programlisting"><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="returnvalue">JsonNode</span></a> *
 614 json_array_dup_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
 615                         <em class="parameter"><code><span class="type">guint</span> index_</code></em>);</pre>
 616 <p>Retrieves a copy of the <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> containing the value of the
 617 element at <em class="parameter"><code>index_</code></em>
 618  inside a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p>
 619 <div class="refsect3">
 620 <a name="json-array-dup-element.parameters"></a><h4>Parameters</h4>
 621 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 622 <colgroup>
 623 <col width="150px" class="parameters_name">
 624 <col class="parameters_description">
 625 <col width="200px" class="parameters_annotations">
 626 </colgroup>
 627 <tbody>
 628 <tr>
 629 <td class="parameter_name"><p>array</p></td>
 630 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 631 <td class="parameter_annotations"> </td>
 632 </tr>
 633 <tr>
 634 <td class="parameter_name"><p>index_</p></td>
 635 <td class="parameter_description"><p>the index of the element to retrieve</p></td>
 636 <td class="parameter_annotations"> </td>
 637 </tr>
 638 </tbody>
 639 </table></div>
 640 </div>
 641 <div class="refsect3">
 642 <a name="json-array-dup-element.returns"></a><h4>Returns</h4>
 643 <p> a copy of the <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> at the requested
 644 index. Use <a class="link" href="json-glib-JSON-Node.html#json-node-unref" title="json_node_unref ()"><code class="function">json_node_unref()</code></a> when done. </p>
 645 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 646 </div>
 647 <p class="since">Since: <a class="link" href="ix04.html#api-index-0.6">0.6</a></p>
 648 </div>
 649 <hr>
 650 <div class="refsect2">
 651 <a name="json-array-get-elements"></a><h3>json_array_get_elements ()</h3>
 652 <pre class="programlisting"><span class="returnvalue">GList</span> *
 653 json_array_get_elements (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>);</pre>
 654 <p>Gets the elements of a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> as a list of <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> instances.</p>
 655 <div class="refsect3">
 656 <a name="json-array-get-elements.parameters"></a><h4>Parameters</h4>
 657 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 658 <colgroup>
 659 <col width="150px" class="parameters_name">
 660 <col class="parameters_description">
 661 <col width="200px" class="parameters_annotations">
 662 </colgroup>
 663 <tbody><tr>
 664 <td class="parameter_name"><p>array</p></td>
 665 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 666 <td class="parameter_annotations"> </td>
 667 </tr></tbody>
 668 </table></div>
 669 </div>
 670 <div class="refsect3">
 671 <a name="json-array-get-elements.returns"></a><h4>Returns</h4>
 672 <p> a <span class="type">GList</span>
 673 containing the elements of the array. The contents of the list are
 674 owned by the array and should never be modified or freed. Use
 675 <code class="function">g_list_free()</code> on the returned list when done using it. </p>
 676 <p><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></p>
 677 </div>
 678 </div>
 679 <hr>
 680 <div class="refsect2">
 681 <a name="json-array-get-length"></a><h3>json_array_get_length ()</h3>
 682 <pre class="programlisting"><span class="returnvalue">guint</span>
 683 json_array_get_length (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>);</pre>
 684 <p>Retrieves the length of a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p>
 685 <div class="refsect3">
 686 <a name="json-array-get-length.parameters"></a><h4>Parameters</h4>
 687 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 688 <colgroup>
 689 <col width="150px" class="parameters_name">
 690 <col class="parameters_description">
 691 <col width="200px" class="parameters_annotations">
 692 </colgroup>
 693 <tbody><tr>
 694 <td class="parameter_name"><p>array</p></td>
 695 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 696 <td class="parameter_annotations"> </td>
 697 </tr></tbody>
 698 </table></div>
 699 </div>
 700 <div class="refsect3">
 701 <a name="json-array-get-length.returns"></a><h4>Returns</h4>
 702 <p> the length of the array</p>
 703 </div>
 704 </div>
 705 <hr>
 706 <div class="refsect2">
 707 <a name="json-array-remove-element"></a><h3>json_array_remove_element ()</h3>
 708 <pre class="programlisting"><span class="returnvalue">void</span>
 709 json_array_remove_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
 710                            <em class="parameter"><code><span class="type">guint</span> index_</code></em>);</pre>
 711 <p>Removes the <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> inside <em class="parameter"><code>array</code></em>
 712  at <em class="parameter"><code>index_</code></em>
 713  freeing its allocated
 714 resources.</p>
 715 <div class="refsect3">
 716 <a name="json-array-remove-element.parameters"></a><h4>Parameters</h4>
 717 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 718 <colgroup>
 719 <col width="150px" class="parameters_name">
 720 <col class="parameters_description">
 721 <col width="200px" class="parameters_annotations">
 722 </colgroup>
 723 <tbody>
 724 <tr>
 725 <td class="parameter_name"><p>array</p></td>
 726 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 727 <td class="parameter_annotations"> </td>
 728 </tr>
 729 <tr>
 730 <td class="parameter_name"><p>index_</p></td>
 731 <td class="parameter_description"><p>the position of the element to be removed</p></td>
 732 <td class="parameter_annotations"> </td>
 733 </tr>
 734 </tbody>
 735 </table></div>
 736 </div>
 737 </div>
 738 <hr>
 739 <div class="refsect2">
 740 <a name="JsonArrayForeach"></a><h3>JsonArrayForeach ()</h3>
 741 <pre class="programlisting"><span class="returnvalue">void</span>
 742 <span class="c_punctuation">(</span>*JsonArrayForeach<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
 743                      <em class="parameter"><code><span class="type">guint</span> index_</code></em>,
 744                      <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> *element_node</code></em>,
 745                      <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
 746 <p>The function to be passed to <a class="link" href="json-glib-JSON-Array.html#json-array-foreach-element" title="json_array_foreach_element ()"><code class="function">json_array_foreach_element()</code></a>. You
 747 should not add or remove elements to and from <em class="parameter"><code>array</code></em>
 748  within
 749 this function. It is safe to change the value of <em class="parameter"><code>element_node</code></em>
 750 .</p>
 751 <div class="refsect3">
 752 <a name="JsonArrayForeach.parameters"></a><h4>Parameters</h4>
 753 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 754 <colgroup>
 755 <col width="150px" class="parameters_name">
 756 <col class="parameters_description">
 757 <col width="200px" class="parameters_annotations">
 758 </colgroup>
 759 <tbody>
 760 <tr>
 761 <td class="parameter_name"><p>array</p></td>
 762 <td class="parameter_description"><p>the iterated <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 763 <td class="parameter_annotations"> </td>
 764 </tr>
 765 <tr>
 766 <td class="parameter_name"><p>index_</p></td>
 767 <td class="parameter_description"><p>the index of the element</p></td>
 768 <td class="parameter_annotations"> </td>
 769 </tr>
 770 <tr>
 771 <td class="parameter_name"><p>element_node</p></td>
 772 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> containing the value at <em class="parameter"><code>index_</code></em>
 773 </p></td>
 774 <td class="parameter_annotations"> </td>
 775 </tr>
 776 <tr>
 777 <td class="parameter_name"><p>user_data</p></td>
 778 <td class="parameter_description"><p>data passed to the function</p></td>
 779 <td class="parameter_annotations"> </td>
 780 </tr>
 781 </tbody>
 782 </table></div>
 783 </div>
 784 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 785 </div>
 786 <hr>
 787 <div class="refsect2">
 788 <a name="json-array-foreach-element"></a><h3>json_array_foreach_element ()</h3>
 789 <pre class="programlisting"><span class="returnvalue">void</span>
 790 json_array_foreach_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
 791                             <em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArrayForeach" title="JsonArrayForeach ()"><span class="type">JsonArrayForeach</span></a> func</code></em>,
 792                             <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
 793 <p>Iterates over all elements of <em class="parameter"><code>array</code></em>
 794  and calls <em class="parameter"><code>func</code></em>
 795  on
 796 each one of them.</p>
 797 <p>It is safe to change the value of a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> of the <em class="parameter"><code>array</code></em>
 798
 799 from within the iterator <em class="parameter"><code>func</code></em>
 800 , but it is not safe to add or
 801 remove elements from the <em class="parameter"><code>array</code></em>
 802 .</p>
 803 <div class="refsect3">
 804 <a name="json-array-foreach-element.parameters"></a><h4>Parameters</h4>
 805 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 806 <colgroup>
 807 <col width="150px" class="parameters_name">
 808 <col class="parameters_description">
 809 <col width="200px" class="parameters_annotations">
 810 </colgroup>
 811 <tbody>
 812 <tr>
 813 <td class="parameter_name"><p>array</p></td>
 814 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 815 <td class="parameter_annotations"> </td>
 816 </tr>
 817 <tr>
 818 <td class="parameter_name"><p>func</p></td>
 819 <td class="parameter_description"><p> the function to be called on each element. </p></td>
 820 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
 821 </tr>
 822 <tr>
 823 <td class="parameter_name"><p>data</p></td>
 824 <td class="parameter_description"><p> data to be passed to the function. </p></td>
 825 <td class="parameter_annotations"><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></td>
 826 </tr>
 827 </tbody>
 828 </table></div>
 829 </div>
 830 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 831 </div>
 832 <hr>
 833 <div class="refsect2">
 834 <a name="json-array-add-array-element"></a><h3>json_array_add_array_element ()</h3>
 835 <pre class="programlisting"><span class="returnvalue">void</span>
 836 json_array_add_array_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
 837                               <em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *value</code></em>);</pre>
 838 <p>Conveniently adds an array into <em class="parameter"><code>array</code></em>
 839 . The <em class="parameter"><code>array</code></em>
 840  takes ownership
 841 of the newly added <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p>
 842 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-add-element" title="json_array_add_element ()"><code class="function">json_array_add_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#json-node-take-array" title="json_node_take_array ()"><code class="function">json_node_take_array()</code></a></p>
 843 <div class="refsect3">
 844 <a name="json-array-add-array-element.parameters"></a><h4>Parameters</h4>
 845 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 846 <colgroup>
 847 <col width="150px" class="parameters_name">
 848 <col class="parameters_description">
 849 <col width="200px" class="parameters_annotations">
 850 </colgroup>
 851 <tbody>
 852 <tr>
 853 <td class="parameter_name"><p>array</p></td>
 854 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 855 <td class="parameter_annotations"> </td>
 856 </tr>
 857 <tr>
 858 <td class="parameter_name"><p>value</p></td>
 859 <td class="parameter_description"><p> a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a>. </p></td>
 860 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
 861 </tr>
 862 </tbody>
 863 </table></div>
 864 </div>
 865 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 866 </div>
 867 <hr>
 868 <div class="refsect2">
 869 <a name="json-array-get-array-element"></a><h3>json_array_get_array_element ()</h3>
 870 <pre class="programlisting"><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="returnvalue">JsonArray</span></a> *
 871 json_array_get_array_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
 872                               <em class="parameter"><code><span class="type">guint</span> index_</code></em>);</pre>
 873 <p>Conveniently retrieves the array from the element at <em class="parameter"><code>index_</code></em>
 874
 875 inside <em class="parameter"><code>array</code></em>
 876 </p>
 877 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-get-element" title="json_array_get_element ()"><code class="function">json_array_get_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#json-node-get-array" title="json_node_get_array ()"><code class="function">json_node_get_array()</code></a></p>
 878 <div class="refsect3">
 879 <a name="json-array-get-array-element.parameters"></a><h4>Parameters</h4>
 880 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 881 <colgroup>
 882 <col width="150px" class="parameters_name">
 883 <col class="parameters_description">
 884 <col width="200px" class="parameters_annotations">
 885 </colgroup>
 886 <tbody>
 887 <tr>
 888 <td class="parameter_name"><p>array</p></td>
 889 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 890 <td class="parameter_annotations"> </td>
 891 </tr>
 892 <tr>
 893 <td class="parameter_name"><p>index_</p></td>
 894 <td class="parameter_description"><p>the index of the element to retrieve</p></td>
 895 <td class="parameter_annotations"> </td>
 896 </tr>
 897 </tbody>
 898 </table></div>
 899 </div>
 900 <div class="refsect3">
 901 <a name="json-array-get-array-element.returns"></a><h4>Returns</h4>
 902 <p> the array. </p>
 903 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 904 </div>
 905 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 906 </div>
 907 <hr>
 908 <div class="refsect2">
 909 <a name="json-array-add-boolean-element"></a><h3>json_array_add_boolean_element ()</h3>
 910 <pre class="programlisting"><span class="returnvalue">void</span>
 911 json_array_add_boolean_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
 912                                 <em class="parameter"><code><span class="type">gboolean</span> value</code></em>);</pre>
 913 <p>Conveniently adds a boolean <em class="parameter"><code>value</code></em>
 914  into <em class="parameter"><code>array</code></em>
 915 </p>
 916 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-add-element" title="json_array_add_element ()"><code class="function">json_array_add_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#json-node-set-boolean" title="json_node_set_boolean ()"><code class="function">json_node_set_boolean()</code></a></p>
 917 <div class="refsect3">
 918 <a name="json-array-add-boolean-element.parameters"></a><h4>Parameters</h4>
 919 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 920 <colgroup>
 921 <col width="150px" class="parameters_name">
 922 <col class="parameters_description">
 923 <col width="200px" class="parameters_annotations">
 924 </colgroup>
 925 <tbody>
 926 <tr>
 927 <td class="parameter_name"><p>array</p></td>
 928 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 929 <td class="parameter_annotations"> </td>
 930 </tr>
 931 <tr>
 932 <td class="parameter_name"><p>value</p></td>
 933 <td class="parameter_description"><p>a boolean value</p></td>
 934 <td class="parameter_annotations"> </td>
 935 </tr>
 936 </tbody>
 937 </table></div>
 938 </div>
 939 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 940 </div>
 941 <hr>
 942 <div class="refsect2">
 943 <a name="json-array-get-boolean-element"></a><h3>json_array_get_boolean_element ()</h3>
 944 <pre class="programlisting"><span class="returnvalue">gboolean</span>
 945 json_array_get_boolean_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
 946                                 <em class="parameter"><code><span class="type">guint</span> index_</code></em>);</pre>
 947 <p>Conveniently retrieves the boolean value of the element at <em class="parameter"><code>index_</code></em>
 948
 949 inside <em class="parameter"><code>array</code></em>
 950 </p>
 951 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-get-element" title="json_array_get_element ()"><code class="function">json_array_get_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#json-node-get-boolean" title="json_node_get_boolean ()"><code class="function">json_node_get_boolean()</code></a></p>
 952 <div class="refsect3">
 953 <a name="json-array-get-boolean-element.parameters"></a><h4>Parameters</h4>
 954 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 955 <colgroup>
 956 <col width="150px" class="parameters_name">
 957 <col class="parameters_description">
 958 <col width="200px" class="parameters_annotations">
 959 </colgroup>
 960 <tbody>
 961 <tr>
 962 <td class="parameter_name"><p>array</p></td>
 963 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
 964 <td class="parameter_annotations"> </td>
 965 </tr>
 966 <tr>
 967 <td class="parameter_name"><p>index_</p></td>
 968 <td class="parameter_description"><p>the index of the element to retrieve</p></td>
 969 <td class="parameter_annotations"> </td>
 970 </tr>
 971 </tbody>
 972 </table></div>
 973 </div>
 974 <div class="refsect3">
 975 <a name="json-array-get-boolean-element.returns"></a><h4>Returns</h4>
 976 <p> the integer value</p>
 977 </div>
 978 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 979 </div>
 980 <hr>
 981 <div class="refsect2">
 982 <a name="json-array-add-double-element"></a><h3>json_array_add_double_element ()</h3>
 983 <pre class="programlisting"><span class="returnvalue">void</span>
 984 json_array_add_double_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
 985                                <em class="parameter"><code><span class="type">gdouble</span> value</code></em>);</pre>
 986 <p>Conveniently adds a floating point <em class="parameter"><code>value</code></em>
 987  into <em class="parameter"><code>array</code></em>
 988 </p>
 989 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-add-element" title="json_array_add_element ()"><code class="function">json_array_add_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#json-node-set-double" title="json_node_set_double ()"><code class="function">json_node_set_double()</code></a></p>
 990 <div class="refsect3">
 991 <a name="json-array-add-double-element.parameters"></a><h4>Parameters</h4>
 992 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 993 <colgroup>
 994 <col width="150px" class="parameters_name">
 995 <col class="parameters_description">
 996 <col width="200px" class="parameters_annotations">
 997 </colgroup>
 998 <tbody>
 999 <tr>
1000 <td class="parameter_name"><p>array</p></td>
1001 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
1002 <td class="parameter_annotations"> </td>
1003 </tr>
1004 <tr>
1005 <td class="parameter_name"><p>value</p></td>
1006 <td class="parameter_description"><p>a floating point value</p></td>
1007 <td class="parameter_annotations"> </td>
1008 </tr>
1009 </tbody>
1010 </table></div>
1011 </div>
1012 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
1013 </div>
1014 <hr>
1015 <div class="refsect2">
1016 <a name="json-array-get-double-element"></a><h3>json_array_get_double_element ()</h3>
1017 <pre class="programlisting"><span class="returnvalue">gdouble</span>
1018 json_array_get_double_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
1019                                <em class="parameter"><code><span class="type">guint</span> index_</code></em>);</pre>
1020 <p>Conveniently retrieves the floating point value of the element at
1021 <em class="parameter"><code>index_</code></em>
1022  inside <em class="parameter"><code>array</code></em>
1023 </p>
1024 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-get-element" title="json_array_get_element ()"><code class="function">json_array_get_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#json-node-get-double" title="json_node_get_double ()"><code class="function">json_node_get_double()</code></a></p>
1025 <div class="refsect3">
1026 <a name="json-array-get-double-element.parameters"></a><h4>Parameters</h4>
1027 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1028 <colgroup>
1029 <col width="150px" class="parameters_name">
1030 <col class="parameters_description">
1031 <col width="200px" class="parameters_annotations">
1032 </colgroup>
1033 <tbody>
1034 <tr>
1035 <td class="parameter_name"><p>array</p></td>
1036 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
1037 <td class="parameter_annotations"> </td>
1038 </tr>
1039 <tr>
1040 <td class="parameter_name"><p>index_</p></td>
1041 <td class="parameter_description"><p>the index of the element to retrieve</p></td>
1042 <td class="parameter_annotations"> </td>
1043 </tr>
1044 </tbody>
1045 </table></div>
1046 </div>
1047 <div class="refsect3">
1048 <a name="json-array-get-double-element.returns"></a><h4>Returns</h4>
1049 <p> the floating point value</p>
1050 </div>
1051 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
1052 </div>
1053 <hr>
1054 <div class="refsect2">
1055 <a name="json-array-add-int-element"></a><h3>json_array_add_int_element ()</h3>
1056 <pre class="programlisting"><span class="returnvalue">void</span>
1057 json_array_add_int_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
1058                             <em class="parameter"><code><span class="type">gint64</span> value</code></em>);</pre>
1059 <p>Conveniently adds an integer <em class="parameter"><code>value</code></em>
1060  into <em class="parameter"><code>array</code></em>
1061 </p>
1062 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-add-element" title="json_array_add_element ()"><code class="function">json_array_add_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#json-node-set-int" title="json_node_set_int ()"><code class="function">json_node_set_int()</code></a></p>
1063 <div class="refsect3">
1064 <a name="json-array-add-int-element.parameters"></a><h4>Parameters</h4>
1065 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1066 <colgroup>
1067 <col width="150px" class="parameters_name">
1068 <col class="parameters_description">
1069 <col width="200px" class="parameters_annotations">
1070 </colgroup>
1071 <tbody>
1072 <tr>
1073 <td class="parameter_name"><p>array</p></td>
1074 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
1075 <td class="parameter_annotations"> </td>
1076 </tr>
1077 <tr>
1078 <td class="parameter_name"><p>value</p></td>
1079 <td class="parameter_description"><p>an integer value</p></td>
1080 <td class="parameter_annotations"> </td>
1081 </tr>
1082 </tbody>
1083 </table></div>
1084 </div>
1085 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
1086 </div>
1087 <hr>
1088 <div class="refsect2">
1089 <a name="json-array-get-int-element"></a><h3>json_array_get_int_element ()</h3>
1090 <pre class="programlisting"><span class="returnvalue">gint64</span>
1091 json_array_get_int_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
1092                             <em class="parameter"><code><span class="type">guint</span> index_</code></em>);</pre>
1093 <p>Conveniently retrieves the integer value of the element at <em class="parameter"><code>index_</code></em>
1094
1095 inside <em class="parameter"><code>array</code></em>
1096 </p>
1097 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-get-element" title="json_array_get_element ()"><code class="function">json_array_get_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#json-node-get-int" title="json_node_get_int ()"><code class="function">json_node_get_int()</code></a></p>
1098 <div class="refsect3">
1099 <a name="json-array-get-int-element.parameters"></a><h4>Parameters</h4>
1100 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1101 <colgroup>
1102 <col width="150px" class="parameters_name">
1103 <col class="parameters_description">
1104 <col width="200px" class="parameters_annotations">
1105 </colgroup>
1106 <tbody>
1107 <tr>
1108 <td class="parameter_name"><p>array</p></td>
1109 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
1110 <td class="parameter_annotations"> </td>
1111 </tr>
1112 <tr>
1113 <td class="parameter_name"><p>index_</p></td>
1114 <td class="parameter_description"><p>the index of the element to retrieve</p></td>
1115 <td class="parameter_annotations"> </td>
1116 </tr>
1117 </tbody>
1118 </table></div>
1119 </div>
1120 <div class="refsect3">
1121 <a name="json-array-get-int-element.returns"></a><h4>Returns</h4>
1122 <p> the integer value</p>
1123 </div>
1124 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
1125 </div>
1126 <hr>
1127 <div class="refsect2">
1128 <a name="json-array-add-null-element"></a><h3>json_array_add_null_element ()</h3>
1129 <pre class="programlisting"><span class="returnvalue">void</span>
1130 json_array_add_null_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>);</pre>
1131 <p>Conveniently adds a null element into <em class="parameter"><code>array</code></em>
1132 </p>
1133 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-add-element" title="json_array_add_element ()"><code class="function">json_array_add_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#JSON-NODE-NULL:CAPS"><code class="literal">JSON_NODE_NULL</code></a></p>
1134 <div class="refsect3">
1135 <a name="json-array-add-null-element.parameters"></a><h4>Parameters</h4>
1136 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1137 <colgroup>
1138 <col width="150px" class="parameters_name">
1139 <col class="parameters_description">
1140 <col width="200px" class="parameters_annotations">
1141 </colgroup>
1142 <tbody><tr>
1143 <td class="parameter_name"><p>array</p></td>
1144 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
1145 <td class="parameter_annotations"> </td>
1146 </tr></tbody>
1147 </table></div>
1148 </div>
1149 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
1150 </div>
1151 <hr>
1152 <div class="refsect2">
1153 <a name="json-array-get-null-element"></a><h3>json_array_get_null_element ()</h3>
1154 <pre class="programlisting"><span class="returnvalue">gboolean</span>
1155 json_array_get_null_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
1156                              <em class="parameter"><code><span class="type">guint</span> index_</code></em>);</pre>
1157 <p>Conveniently retrieves whether the element at <em class="parameter"><code>index_</code></em>
1158  is set to null</p>
1159 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-get-element" title="json_array_get_element ()"><code class="function">json_array_get_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#JSON-NODE-TYPE:CAPS" title="JSON_NODE_TYPE()"><code class="function">JSON_NODE_TYPE()</code></a>, <a class="link" href="json-glib-JSON-Node.html#JSON-NODE-NULL:CAPS"><code class="literal">JSON_NODE_NULL</code></a></p>
1160 <div class="refsect3">
1161 <a name="json-array-get-null-element.parameters"></a><h4>Parameters</h4>
1162 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1163 <colgroup>
1164 <col width="150px" class="parameters_name">
1165 <col class="parameters_description">
1166 <col width="200px" class="parameters_annotations">
1167 </colgroup>
1168 <tbody>
1169 <tr>
1170 <td class="parameter_name"><p>array</p></td>
1171 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
1172 <td class="parameter_annotations"> </td>
1173 </tr>
1174 <tr>
1175 <td class="parameter_name"><p>index_</p></td>
1176 <td class="parameter_description"><p>the index of the element to retrieve</p></td>
1177 <td class="parameter_annotations"> </td>
1178 </tr>
1179 </tbody>
1180 </table></div>
1181 </div>
1182 <div class="refsect3">
1183 <a name="json-array-get-null-element.returns"></a><h4>Returns</h4>
1184 <p> <code class="literal">TRUE</code> if the element is null</p>
1185 </div>
1186 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
1187 </div>
1188 <hr>
1189 <div class="refsect2">
1190 <a name="json-array-add-object-element"></a><h3>json_array_add_object_element ()</h3>
1191 <pre class="programlisting"><span class="returnvalue">void</span>
1192 json_array_add_object_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
1193                                <em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> *value</code></em>);</pre>
1194 <p>Conveniently adds an object into <em class="parameter"><code>array</code></em>
1195 . The <em class="parameter"><code>array</code></em>
1196  takes ownership
1197 of the newly added <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a></p>
1198 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-add-element" title="json_array_add_element ()"><code class="function">json_array_add_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#json-node-take-object" title="json_node_take_object ()"><code class="function">json_node_take_object()</code></a></p>
1199 <div class="refsect3">
1200 <a name="json-array-add-object-element.parameters"></a><h4>Parameters</h4>
1201 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1202 <colgroup>
1203 <col width="150px" class="parameters_name">
1204 <col class="parameters_description">
1205 <col width="200px" class="parameters_annotations">
1206 </colgroup>
1207 <tbody>
1208 <tr>
1209 <td class="parameter_name"><p>array</p></td>
1210 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
1211 <td class="parameter_annotations"> </td>
1212 </tr>
1213 <tr>
1214 <td class="parameter_name"><p>value</p></td>
1215 <td class="parameter_description"><p> a <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>. </p></td>
1216 <td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
1217 </tr>
1218 </tbody>
1219 </table></div>
1220 </div>
1221 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
1222 </div>
1223 <hr>
1224 <div class="refsect2">
1225 <a name="json-array-get-object-element"></a><h3>json_array_get_object_element ()</h3>
1226 <pre class="programlisting"><a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="returnvalue">JsonObject</span></a> *
1227 json_array_get_object_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
1228                                <em class="parameter"><code><span class="type">guint</span> index_</code></em>);</pre>
1229 <p>Conveniently retrieves the object from the element at <em class="parameter"><code>index_</code></em>
1230
1231 inside <em class="parameter"><code>array</code></em>
1232 </p>
1233 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-get-element" title="json_array_get_element ()"><code class="function">json_array_get_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#json-node-get-object" title="json_node_get_object ()"><code class="function">json_node_get_object()</code></a></p>
1234 <div class="refsect3">
1235 <a name="json-array-get-object-element.parameters"></a><h4>Parameters</h4>
1236 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1237 <colgroup>
1238 <col width="150px" class="parameters_name">
1239 <col class="parameters_description">
1240 <col width="200px" class="parameters_annotations">
1241 </colgroup>
1242 <tbody>
1243 <tr>
1244 <td class="parameter_name"><p>array</p></td>
1245 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
1246 <td class="parameter_annotations"> </td>
1247 </tr>
1248 <tr>
1249 <td class="parameter_name"><p>index_</p></td>
1250 <td class="parameter_description"><p>the index of the element to retrieve</p></td>
1251 <td class="parameter_annotations"> </td>
1252 </tr>
1253 </tbody>
1254 </table></div>
1255 </div>
1256 <div class="refsect3">
1257 <a name="json-array-get-object-element.returns"></a><h4>Returns</h4>
1258 <p> the object. </p>
1259 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1260 </div>
1261 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
1262 </div>
1263 <hr>
1264 <div class="refsect2">
1265 <a name="json-array-add-string-element"></a><h3>json_array_add_string_element ()</h3>
1266 <pre class="programlisting"><span class="returnvalue">void</span>
1267 json_array_add_string_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
1268                                <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
1269 <p>Conveniently adds a string <em class="parameter"><code>value</code></em>
1270  into <em class="parameter"><code>array</code></em>
1271 </p>
1272 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-add-element" title="json_array_add_element ()"><code class="function">json_array_add_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#json-node-set-string" title="json_node_set_string ()"><code class="function">json_node_set_string()</code></a></p>
1273 <div class="refsect3">
1274 <a name="json-array-add-string-element.parameters"></a><h4>Parameters</h4>
1275 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1276 <colgroup>
1277 <col width="150px" class="parameters_name">
1278 <col class="parameters_description">
1279 <col width="200px" class="parameters_annotations">
1280 </colgroup>
1281 <tbody>
1282 <tr>
1283 <td class="parameter_name"><p>array</p></td>
1284 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
1285 <td class="parameter_annotations"> </td>
1286 </tr>
1287 <tr>
1288 <td class="parameter_name"><p>value</p></td>
1289 <td class="parameter_description"><p>a string value</p></td>
1290 <td class="parameter_annotations"> </td>
1291 </tr>
1292 </tbody>
1293 </table></div>
1294 </div>
1295 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
1296 </div>
1297 <hr>
1298 <div class="refsect2">
1299 <a name="json-array-get-string-element"></a><h3>json_array_get_string_element ()</h3>
1300 <pre class="programlisting">const <span class="returnvalue">gchar</span> *
1301 json_array_get_string_element (<em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> *array</code></em>,
1302                                <em class="parameter"><code><span class="type">guint</span> index_</code></em>);</pre>
1303 <p>Conveniently retrieves the string value of the element at <em class="parameter"><code>index_</code></em>
1304
1305 inside <em class="parameter"><code>array</code></em>
1306 </p>
1307 <p>See also: <a class="link" href="json-glib-JSON-Array.html#json-array-get-element" title="json_array_get_element ()"><code class="function">json_array_get_element()</code></a>, <a class="link" href="json-glib-JSON-Node.html#json-node-get-string" title="json_node_get_string ()"><code class="function">json_node_get_string()</code></a></p>
1308 <div class="refsect3">
1309 <a name="json-array-get-string-element.parameters"></a><h4>Parameters</h4>
1310 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1311 <colgroup>
1312 <col width="150px" class="parameters_name">
1313 <col class="parameters_description">
1314 <col width="200px" class="parameters_annotations">
1315 </colgroup>
1316 <tbody>
1317 <tr>
1318 <td class="parameter_name"><p>array</p></td>
1319 <td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p></td>
1320 <td class="parameter_annotations"> </td>
1321 </tr>
1322 <tr>
1323 <td class="parameter_name"><p>index_</p></td>
1324 <td class="parameter_description"><p>the index of the element to retrieve</p></td>
1325 <td class="parameter_annotations"> </td>
1326 </tr>
1327 </tbody>
1328 </table></div>
1329 </div>
1330 <div class="refsect3">
1331 <a name="json-array-get-string-element.returns"></a><h4>Returns</h4>
1332 <p> the string value; the returned string is owned by
1333 the <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> and should not be modified or freed</p>
1334 </div>
1335 <p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
1336 </div>
1337 </div>
1338 <div class="refsect1">
1339 <a name="json-glib-JSON-Array.other_details"></a><h2>Types and Values</h2>
1340 <div class="refsect2">
1341 <a name="JsonArray-struct"></a><h3>JsonArray</h3>
1342 <pre class="programlisting">typedef struct _JsonArray JsonArray;</pre>
1343 <p>A JSON array type. The contents of the <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> structure are private
1344 and should only be accessed by the provided API</p>
1345 </div>
1346 </div>
1347 </div>
1348 <div class="footer">
1349 <hr>Generated by GTK-Doc V1.25.1</div>
1350 </body>
1351 </html>