RubyGems - clutter - Versions diffs - 3.0.7-x64-mingw32 → 3.0.8-x64-mingw32 - Mend

clutter 3.0.7-x64-mingw32 → 3.0.8-x64-mingw32

Files changed (543) hide show

data/vendor/local/share/gtk-doc/html/json-glib/json-glib-JSON-Object.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="ch01.html" title="Data Types">
 <link rel="prev" href="json-glib-JSON-Array.html" title="JSON Array">
 <link rel="next" href="json-streams.html" title="Part III. Reading and writing">
-<meta name="generator" content="GTK-Doc V1.21.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -69,6 +69,38 @@
 <span class="returnvalue">void</span>
 </td>
 <td class="function_name">
+<a class="link" href="json-glib-JSON-Object.html#json-object-seal" title="json_object_seal ()">json_object_seal</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="json-glib-JSON-Object.html#json-object-is-immutable" title="json_object_is_immutable ()">json_object_is_immutable</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">guint</span>
+</td>
+<td class="function_name">
+<a class="link" href="json-glib-JSON-Object.html#json-object-hash" title="json_object_hash ()">json_object_hash</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="json-glib-JSON-Object.html#json-object-equal" title="json_object_equal ()">json_object_equal</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
 <a class="link" href="json-glib-JSON-Object.html#json-object-add-member" title="json_object_add_member ()">json_object_add_member</a> <span class="c_punctuation">()</span>
 </td>
 </tr>
@@ -157,6 +189,22 @@
 <span class="returnvalue">void</span>
 </td>
 <td class="function_name">
+<a class="link" href="json-glib-JSON-Object.html#json-object-iter-init" title="json_object_iter_init ()">json_object_iter_init</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="json-glib-JSON-Object.html#json-object-iter-next" title="json_object_iter_next ()">json_object_iter_next</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
 <a class="link" href="json-glib-JSON-Object.html#json-object-set-array-member" title="json_object_set_array_member ()">json_object_set_array_member</a> <span class="c_punctuation">()</span>
 </td>
 </tr>
@@ -273,10 +321,16 @@
 <col width="150px" class="name">
 <col class="description">
 </colgroup>
-<tbody><tr>
+<tbody>
+<tr>
 <td class="datatype_keyword"> </td>
 <td class="function_name"><a class="link" href="json-glib-JSON-Object.html#JsonObject-struct" title="JsonObject">JsonObject</a></td>
-</tr></tbody>
+</tr>
+<tr>
+<td class="datatype_keyword"> </td>
+<td class="function_name"><a class="link" href="json-glib-JSON-Object.html#JsonObjectIter" title="JsonObjectIter">JsonObjectIter</a></td>
+</tr>
+</tbody>
 </table></div>
 </div>
 <div class="refsect1">
@@ -306,8 +360,9 @@ use <a class="link" href="json-glib-JSON-Object.html#json-object-get-size" title
 <pre class="programlisting"><a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="returnvalue">JsonObject</span></a> *
 json_object_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 <p>Creates a new <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>, an JSON object type representation.</p>
+<p><span class="annotation">[<acronym title="This symbol is a constructor, not a static method."><span class="acronym">constructor</span></acronym>]</span></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.2.5"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.2.6"></a><h4>Returns</h4>
 <p> the newly created <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
@@ -366,6 +421,134 @@ its allocated resources are freed.</p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="json-object-seal"></a><h3>json_object_seal ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+json_object_seal (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
+<p>Seals the <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>, making it immutable to further changes. This will
+recursively seal all members of the object too.</p>
+<p>If the <em class="parameter"><code>object</code></em>
+ is already immutable, this is a no-op.</p>
+<div class="refsect3">
+<a name="id-1.3.3.4.8.5.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>object</p></td>
+<td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<p class="since">Since: <a class="link" href="ix11.html#api-index-1.2">1.2</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="json-object-is-immutable"></a><h3>json_object_is_immutable ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+json_object_is_immutable (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
+<p>Check whether the given <em class="parameter"><code>object</code></em>
+ has been marked as immutable by calling
+<a class="link" href="json-glib-JSON-Object.html#json-object-seal" title="json_object_seal ()"><code class="function">json_object_seal()</code></a> on it.</p>
+<div class="refsect3">
+<a name="id-1.3.3.4.8.6.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>object</p></td>
+<td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.3.3.4.8.6.6"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> if the <em class="parameter"><code>object</code></em>
+is immutable</p>
+</div>
+<p class="since">Since: <a class="link" href="ix11.html#api-index-1.2">1.2</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="json-object-hash"></a><h3>json_object_hash ()</h3>
+<pre class="programlisting"><span class="returnvalue">guint</span>
+json_object_hash (<em class="parameter"><code><span class="type">gconstpointer</span> key</code></em>);</pre>
+<p>Calculate a hash value for the given <em class="parameter"><code>key</code></em>
+ (a <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>).</p>
+<p>The hash is calculated over the object and all its members, recursively. If
+the object is immutable, this is a fast operation; otherwise, it scales
+proportionally with the number of members in the object.</p>
+<div class="refsect3">
+<a name="id-1.3.3.4.8.7.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>key</p></td>
+<td class="parameter_description"><p> a JSON object to hash. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> JsonObject]</span></td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.3.3.4.8.7.7"></a><h4>Returns</h4>
+<p> hash value for <em class="parameter"><code>key</code></em>
+</p>
+</div>
+<p class="since">Since: <a class="link" href="ix11.html#api-index-1.2">1.2</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="json-object-equal"></a><h3>json_object_equal ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+json_object_equal (<em class="parameter"><code><span class="type">gconstpointer</span> a</code></em>,
+                   <em class="parameter"><code><span class="type">gconstpointer</span> b</code></em>);</pre>
+<p>Check whether <em class="parameter"><code>a</code></em>
+ and <em class="parameter"><code>b</code></em>
+ are equal <a href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObjects</span></a>, meaning they have the same
+set of members, and the values of corresponding members are equal.</p>
+<div class="refsect3">
+<a name="id-1.3.3.4.8.8.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>a</p></td>
+<td class="parameter_description"><p> a JSON object. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> JsonObject]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>b</p></td>
+<td class="parameter_description"><p> another JSON object. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> JsonObject]</span></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.3.3.4.8.8.6"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> if <em class="parameter"><code>a</code></em>
+and <em class="parameter"><code>b</code></em>
+are equal; <code class="literal">FALSE</code> otherwise</p>
+</div>
+<p class="since">Since: <a class="link" href="ix11.html#api-index-1.2">1.2</a></p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="json-object-add-member"></a><h3>json_object_add_member ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 json_object_add_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
@@ -384,7 +567,7 @@ The object will take ownership of the <a class="link" href="json-glib-JSON-Node.
 <em class="parameter"><code>member_name</code></em>
 .</p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.5.7"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.9.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -429,7 +612,7 @@ the member's current value is overwritten. Otherwise, a new
 member is added to <em class="parameter"><code>object</code></em>
 .</p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.6.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.10.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -455,7 +638,7 @@ member is added to <em class="parameter"><code>object</code></em>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -467,7 +650,7 @@ json_object_has_member (<em class="parameter"><code><a class="link" href="json-g
  has a member named <em class="parameter"><code>member_name</code></em>
 .</p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.7.5"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.11.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -489,9 +672,8 @@ json_object_has_member (<em class="parameter"><code><a class="link" href="json-g
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.7.6"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.11.6"></a><h4>Returns</h4>
 <p> <code class="literal">TRUE</code> if the JSON object has the requested member</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -504,7 +686,7 @@ json_object_get_member (<em class="parameter"><code><a class="link" href="json-g
  inside
 a <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>.</p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.8.5"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.12.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -526,7 +708,7 @@ a <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.8.6"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.12.6"></a><h4>Returns</h4>
 <p> a pointer to the node for the requested object
 member, or <code class="literal">NULL</code>. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
@@ -542,7 +724,7 @@ json_object_dup_member (<em class="parameter"><code><a class="link" href="json-g
 inside a <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.9.5"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.13.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -564,12 +746,12 @@ inside a <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span clas
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.9.6"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.13.6"></a><h4>Returns</h4>
 <p> a copy of the node for the requested
-object member or <code class="literal">NULL</code>. Use <a class="link" href="json-glib-JSON-Node.html#json-node-free" title="json_node_free ()"><code class="function">json_node_free()</code></a> when done. </p>
+object member or <code class="literal">NULL</code>. 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>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 0.6</p>
+<p class="since">Since: <a class="link" href="ix04.html#api-index-0.6">0.6</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -579,7 +761,7 @@ json_object_get_members (<em class="parameter"><code><a class="link" href="json-
 <p>Retrieves all the names of the members of a <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>. You can
 obtain the value for each member using <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.10.5"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.14.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -594,7 +776,7 @@ obtain the value for each member using <a class="link" href="json-glib-JSON-Obje
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.10.6"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.14.6"></a><h4>Returns</h4>
 <p> a <span class="type">GList</span>
 of member names. The content of the list is owned by the <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>
 and should never be modified or freed. When you have finished using
@@ -610,7 +792,7 @@ allocated. </p>
 json_object_get_values (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
 <p>Retrieves all the values of the members of a <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>.</p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.11.5"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.15.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -625,7 +807,7 @@ json_object_get_values (<em class="parameter"><code><a class="link" href="json-g
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.11.6"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.15.6"></a><h4>Returns</h4>
 <p> a <span class="type">GList</span> of
 <a href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNodes</span></a>. The content of the list is owned by the <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>
 and should never be modified or freed. When you have finished using the
@@ -640,7 +822,7 @@ returned list, use <code class="function">g_list_free()</code> to free the resou
 json_object_get_size (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
 <p>Retrieves the number of members of a <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>.</p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.12.5"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.16.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -655,9 +837,8 @@ json_object_get_size (<em class="parameter"><code><a class="link" href="json-gli
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.12.6"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.16.6"></a><h4>Returns</h4>
 <p> the number of members</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -670,7 +851,7 @@ json_object_remove_member (<em class="parameter"><code><a class="link" href="jso
  from <em class="parameter"><code>object</code></em>
 , freeing its allocated resources.</p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.13.5"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.17.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -706,7 +887,7 @@ should not add or remove members to and from <em class="parameter"><code>object<
 this function. It is safe to change the value of <em class="parameter"><code>member_node</code></em>
 .</p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.14.5"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.18.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -738,7 +919,7 @@ value</p></td>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -758,7 +939,7 @@ from within the iterator <em class="parameter"><code>func</code></em>
 remove members from the <em class="parameter"><code>object</code></em>
 .</p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.15.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.19.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -784,7 +965,122 @@ remove members from the <em class="parameter"><code>object</code></em>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="json-object-iter-init"></a><h3>json_object_iter_init ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+json_object_iter_init (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObjectIter" title="JsonObjectIter"><span class="type">JsonObjectIter</span></a> *iter</code></em>,
+                       <em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
+<p>Initialise the <em class="parameter"><code>iter</code></em>
+ and associate it with <em class="parameter"><code>object</code></em>
+.</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="usertype">JsonObjectIter</span><span class="normal"> iter</span><span class="symbol">;</span>
+<span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">member_name</span><span class="symbol">;</span>
+<span class="usertype">JsonNode</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">member_node</span><span class="symbol">;</span>
+<span class="function"><a href="json-glib-JSON-Object.html#json-object-iter-init">json_object_iter_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> some_object</span><span class="symbol">);</span>
+<span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="json-glib-JSON-Object.html#json-object-iter-next">json_object_iter_next</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">member_name</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">member_node</span><span class="symbol">))</span>
+<span class="normal">  </span><span class="cbracket">{</span>
+<span class="normal">    </span><span class="comment">// Do something with @member_name and @member_node.</span>
+<span class="normal">  </span><span class="cbracket">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+<div class="refsect3">
+<a name="id-1.3.3.4.8.20.7"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>iter</p></td>
+<td class="parameter_description"><p>an uninitialised <a class="link" href="json-glib-JSON-Object.html#JsonObjectIter" title="JsonObjectIter"><span class="type">JsonObjectIter</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>object</p></td>
+<td class="parameter_description"><p>the <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> to iterate over</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since: <a class="link" href="ix11.html#api-index-1.2">1.2</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="json-object-iter-next"></a><h3>json_object_iter_next ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+json_object_iter_next (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObjectIter" title="JsonObjectIter"><span class="type">JsonObjectIter</span></a> *iter</code></em>,
+                       <em class="parameter"><code>const <span class="type">gchar</span> **member_name</code></em>,
+                       <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> **member_node</code></em>);</pre>
+<p>Advance <em class="parameter"><code>iter</code></em>
+ and retrieve the next member in the object. If the end of the
+object is reached, <code class="literal">FALSE</code> is returned and <em class="parameter"><code>member_name</code></em>
+ and <em class="parameter"><code>member_node</code></em>
+ are
+set to invalid values. After that point, the <em class="parameter"><code>iter</code></em>
+ is invalid.</p>
+<p>The order in which members are returned by the iterator is undefined. The
+iterator is invalidated if its <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> is modified during iteration.</p>
+<div class="refsect3">
+<a name="id-1.3.3.4.8.21.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>iter</p></td>
+<td class="parameter_description"><p>a <a class="link" href="json-glib-JSON-Object.html#JsonObjectIter" title="JsonObjectIter"><span class="type">JsonObjectIter</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>member_name</p></td>
+<td class="parameter_description"><p> return
+location for the member name, or <code class="literal">NULL</code> to ignore. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>member_node</p></td>
+<td class="parameter_description"><p> return
+location for the member value, or <code class="literal">NULL</code> to ignore. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.3.3.4.8.21.7"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> if <em class="parameter"><code>member_name</code></em>
+and <em class="parameter"><code>member_node</code></em>
+are valid; <code class="literal">FALSE</code> if the end
+of the object has been reached</p>
+</div>
+<p class="since">Since: <a class="link" href="ix11.html#api-index-1.2">1.2</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -802,7 +1098,7 @@ json_object_set_array_member (<em class="parameter"><code><a class="link" href="
  will take ownership of the passed <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a></p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.16.7"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.22.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -828,7 +1124,7 @@ json_object_set_array_member (<em class="parameter"><code><a class="link" href="
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -842,7 +1138,7 @@ stored in <em class="parameter"><code>member_name</code></em>
 </p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.17.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.23.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -864,11 +1160,11 @@ stored in <em class="parameter"><code>member_name</code></em>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.17.7"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.23.7"></a><h4>Returns</h4>
 <p> the array inside the object's member. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -884,7 +1180,7 @@ json_object_set_boolean_member (<em class="parameter"><code><a class="link" href
 .</p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.18.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.24.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -910,7 +1206,7 @@ json_object_set_boolean_member (<em class="parameter"><code><a class="link" href
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -924,7 +1220,7 @@ stored in <em class="parameter"><code>member_name</code></em>
 </p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.19.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.25.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -946,11 +1242,10 @@ stored in <em class="parameter"><code>member_name</code></em>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.19.7"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.25.7"></a><h4>Returns</h4>
 <p> the boolean value of the object's member</p>
-<p></p>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -966,7 +1261,7 @@ of <em class="parameter"><code>member_name</code></em>
 .</p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.20.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.26.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -992,7 +1287,7 @@ of <em class="parameter"><code>member_name</code></em>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1006,7 +1301,7 @@ stored in <em class="parameter"><code>member_name</code></em>
 </p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.21.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.27.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1028,11 +1323,10 @@ stored in <em class="parameter"><code>member_name</code></em>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.21.7"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.27.7"></a><h4>Returns</h4>
 <p> the floating point value of the object's member</p>
-<p></p>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1048,7 +1342,7 @@ json_object_set_int_member (<em class="parameter"><code><a class="link" href="js
 .</p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.22.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.28.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1074,7 +1368,7 @@ json_object_set_int_member (<em class="parameter"><code><a class="link" href="js
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1088,7 +1382,7 @@ stored in <em class="parameter"><code>member_name</code></em>
 </p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.23.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.29.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1110,11 +1404,10 @@ stored in <em class="parameter"><code>member_name</code></em>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.23.7"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.29.7"></a><h4>Returns</h4>
 <p> the integer value of the object's member</p>
-<p></p>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1129,7 +1422,7 @@ json_object_set_null_member (<em class="parameter"><code><a class="link" href="j
 .</p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.24.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.30.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1150,7 +1443,7 @@ json_object_set_null_member (<em class="parameter"><code><a class="link" href="j
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1164,7 +1457,7 @@ stored in <em class="parameter"><code>member_name</code></em>
  is null</p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.25.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.31.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1186,11 +1479,10 @@ stored in <em class="parameter"><code>member_name</code></em>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.25.7"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.31.7"></a><h4>Returns</h4>
 <p> <code class="literal">TRUE</code> if the value is null</p>
-<p></p>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1208,7 +1500,7 @@ json_object_set_object_member (<em class="parameter"><code><a class="link" href=
  will take ownership of the passed <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a></p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.26.7"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.32.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1234,7 +1526,7 @@ json_object_set_object_member (<em class="parameter"><code><a class="link" href=
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1245,10 +1537,12 @@ json_object_get_object_member (<em class="parameter"><code><a class="link" href=
 <p>Convenience function that retrieves the object
 stored in <em class="parameter"><code>member_name</code></em>
  of <em class="parameter"><code>object</code></em>
-</p>
+. It is an error to specify a <em class="parameter"><code>member_name</code></em>
+which does not exist.</p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.27.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.33.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1270,11 +1564,12 @@ stored in <em class="parameter"><code>member_name</code></em>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.27.7"></a><h4>Returns</h4>
-<p> the object inside the object's member. </p>
-<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+<a name="id-1.3.3.4.8.33.7"></a><h4>Returns</h4>
+<p> the object inside the object’s
+member, or <code class="literal">NULL</code> if the value for the member is <code class="literal">null</code>. </p>
+<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1290,7 +1585,7 @@ json_object_set_string_member (<em class="parameter"><code><a class="link" href=
 .</p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.28.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.34.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1316,7 +1611,7 @@ json_object_set_string_member (<em class="parameter"><code><a class="link" href=
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1330,7 +1625,7 @@ stored in <em class="parameter"><code>member_name</code></em>
 </p>
 <p>See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.29.6"></a><h4>Parameters</h4>
+<a name="id-1.3.3.4.8.35.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1352,11 +1647,10 @@ stored in <em class="parameter"><code>member_name</code></em>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.3.4.8.29.7"></a><h4>Returns</h4>
+<a name="id-1.3.3.4.8.35.7"></a><h4>Returns</h4>
 <p> the string value of the object's member</p>
-<p></p>
 </div>
-<p class="since">Since 0.8</p>
+<p class="since">Since: <a class="link" href="ix05.html#api-index-0.8">0.8</a></p>
 </div>
 </div>
 <div class="refsect1">
@@ -1367,10 +1661,23 @@ stored in <em class="parameter"><code>member_name</code></em>
 <p>A JSON object type. The contents of the <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> structure are private
 and should only be accessed by the provided API</p>
 </div>
+<hr>
+<div class="refsect2">
+<a name="JsonObjectIter"></a><h3>JsonObjectIter</h3>
+<pre class="programlisting">typedef struct {
+} JsonObjectIter;
+</pre>
+<p>An iterator used to iterate over the members of a <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>. This must
+be allocated on the stack and initialised using <a class="link" href="json-glib-JSON-Object.html#json-object-iter-init" title="json_object_iter_init ()"><code class="function">json_object_iter_init()</code></a>.
+The order in which members are returned by the iterator is undefined. The
+iterator is invalidated if its <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> is modified during iteration.</p>
+<p>All the fields in the <a class="link" href="json-glib-JSON-Object.html#JsonObjectIter" title="JsonObjectIter"><span class="type">JsonObjectIter</span></a> structure are private and should
+never be accessed directly.</p>
+<p class="since">Since: <a class="link" href="ix11.html#api-index-1.2">1.2</a></p>
+</div>
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21.1</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>