Imported Upstream version 1.2.4
[platform/upstream/json-glib.git] / doc / reference / html / json-glib-JSON-Node.html
index 52d4fb6..b0c71da 100644 (file)
@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>JSON Node: JSON-GLib Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
 <link rel="home" href="index.html" title="JSON-GLib Reference Manual">
 <link rel="up" href="ch01.html" title="Data Types">
 <link rel="prev" href="ch01.html" title="Data Types">
 <link rel="next" href="json-glib-JSON-Array.html" title="JSON Array">
-<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -34,7 +34,7 @@
 </tr></table></div>
 <div class="refsect1">
 <a name="json-glib-JSON-Node.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="functions_return">
 <col class="functions_name">
 </div>
 <a name="JsonNode"></a><div class="refsect1">
 <a name="json-glib-JSON-Node.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="name">
 <col class="description">
 </div>
 <div class="refsect1">
 <a name="json-glib-JSON-Node.object-hierarchy"></a><h2>Object Hierarchy</h2>
-<pre class="screen">    GBoxed
+<pre class="screen">    <a href="/home/ebassi/gnome/install/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a>
     <span class="lineart">╰──</span> JsonNode
 </pre>
 </div>
@@ -511,7 +511,7 @@ and <a class="link" href="json-glib-JSON-Node.html#json-node-unref" title="json_
 </p>
 <div class="refsect3">
 <a name="JSON-NODE-TYPE.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -535,7 +535,7 @@ and <a class="link" href="json-glib-JSON-Node.html#json-node-unref" title="json_
 </p>
 <div class="refsect3">
 <a name="JSON-NODE-HOLDS.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -566,7 +566,7 @@ and <a class="link" href="json-glib-JSON-Node.html#json-node-unref" title="json_
  holds a <a class="link" href="json-glib-JSON-Node.html#JSON-NODE-VALUE:CAPS"><code class="literal">JSON_NODE_VALUE</code></a></p>
 <div class="refsect3">
 <a name="JSON-NODE-HOLDS-VALUE.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -590,7 +590,7 @@ and <a class="link" href="json-glib-JSON-Node.html#json-node-unref" title="json_
  holds a <a class="link" href="json-glib-JSON-Node.html#JSON-NODE-OBJECT:CAPS"><code class="literal">JSON_NODE_OBJECT</code></a></p>
 <div class="refsect3">
 <a name="JSON-NODE-HOLDS-OBJECT.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -614,7 +614,7 @@ and <a class="link" href="json-glib-JSON-Node.html#json-node-unref" title="json_
  holds a <a class="link" href="json-glib-JSON-Node.html#JSON-NODE-ARRAY:CAPS"><code class="literal">JSON_NODE_ARRAY</code></a></p>
 <div class="refsect3">
 <a name="JSON-NODE-HOLDS-ARRAY.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -638,7 +638,7 @@ and <a class="link" href="json-glib-JSON-Node.html#json-node-unref" title="json_
  holds a <a class="link" href="json-glib-JSON-Node.html#JSON-NODE-NULL:CAPS"><code class="literal">JSON_NODE_NULL</code></a></p>
 <div class="refsect3">
 <a name="JSON-NODE-HOLDS-NULL.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -682,7 +682,7 @@ json_node_init (<em class="parameter"><code><a class="link" href="json-glib-JSON
 the given type, and any data contained will be cleared.</p>
 <div class="refsect3">
 <a name="json-node-init.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -723,7 +723,7 @@ json_node_init_int (<em class="parameter"><code><a class="link" href="json-glib-
 the given type, and any data contained will be cleared.</p>
 <div class="refsect3">
 <a name="json-node-init-int.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -763,7 +763,7 @@ json_node_init_double (<em class="parameter"><code><a class="link" href="json-gl
 the given type, and any data contained will be cleared.</p>
 <div class="refsect3">
 <a name="json-node-init-double.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -803,7 +803,7 @@ json_node_init_boolean (<em class="parameter"><code><a class="link" href="json-g
 the given type, and any data contained will be cleared.</p>
 <div class="refsect3">
 <a name="json-node-init-boolean.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -843,7 +843,7 @@ json_node_init_string (<em class="parameter"><code><a class="link" href="json-gl
 the given type, and any data contained will be cleared.</p>
 <div class="refsect3">
 <a name="json-node-init-string.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -881,7 +881,7 @@ json_node_init_null (<em class="parameter"><code><a class="link" href="json-glib
 the given type, and any data contained will be cleared.</p>
 <div class="refsect3">
 <a name="json-node-init-null.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -916,7 +916,7 @@ json_node_init_object (<em class="parameter"><code><a class="link" href="json-gl
 the given type, and any data contained will be cleared.</p>
 <div class="refsect3">
 <a name="json-node-init-object.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -959,7 +959,7 @@ json_node_init_array (<em class="parameter"><code><a class="link" href="json-gli
 the given type, and any data contained will be cleared.</p>
 <div class="refsect3">
 <a name="json-node-init-array.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1011,7 +1011,7 @@ and it's the equivalent of:</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="json-node-new.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1044,7 +1044,7 @@ immutable.</p>
 there should be no need to copy an immutable node.</p>
 <div class="refsect3">
 <a name="json-node-copy.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1072,7 +1072,7 @@ json_node_free (<em class="parameter"><code><a class="link" href="json-glib-JSON
 .</p>
 <div class="refsect3">
 <a name="json-node-free.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1095,7 +1095,7 @@ json_node_ref (<em class="parameter"><code><a class="link" href="json-glib-JSON-
 .</p>
 <div class="refsect3">
 <a name="json-node-ref.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1126,7 +1126,7 @@ json_node_unref (<em class="parameter"><code><a class="link" href="json-glib-JSO
 freed.</p>
 <div class="refsect3">
 <a name="json-node-unref.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1151,7 +1151,7 @@ json_node_is_immutable (<em class="parameter"><code><a class="link" href="json-g
 <a class="link" href="json-glib-JSON-Node.html#json-node-seal" title="json_node_seal ()"><code class="function">json_node_seal()</code></a> on it.</p>
 <div class="refsect3">
 <a name="json-node-is-immutable.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1185,7 +1185,7 @@ sealed, etc.</p>
  is already immutable, this is a no-op.</p>
 <div class="refsect3">
 <a name="json-node-seal.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1213,7 +1213,7 @@ with the size of the node’s value (for example, with the number of members
 in the <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> if this node contains an object).</p>
 <div class="refsect3">
 <a name="json-node-hash.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1247,7 +1247,7 @@ compared numerically, ignoring type, so a double value 4.0 is equal to the
 integer value 4.</p>
 <div class="refsect3">
 <a name="json-node-equal.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1287,7 +1287,7 @@ json_node_set_array (<em class="parameter"><code><a class="link" href="json-glib
 <p>It is an error to call this on an immutable node.</p>
 <div class="refsect3">
 <a name="json-node-set-array.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1320,7 +1320,7 @@ json_node_take_array (<em class="parameter"><code><a class="link" href="json-gli
 <p>It is an error to call this on an immutable node.</p>
 <div class="refsect3">
 <a name="json-node-take-array.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1346,10 +1346,11 @@ json_node_take_array (<em class="parameter"><code><a class="link" href="json-gli
 <a name="json-node-get-array"></a><h3>json_node_get_array ()</h3>
 <pre class="programlisting"><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="returnvalue">JsonArray</span></a> *
 json_node_get_array (<em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
-<p>Retrieves the <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a></p>
+<p>Retrieves the <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a>. If the node does not
+hold an array value, <code class="literal">NULL</code> is returned.</p>
 <div class="refsect3">
 <a name="json-node-get-array.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1365,7 +1366,7 @@ json_node_get_array (<em class="parameter"><code><a class="link" href="json-glib
 <div class="refsect3">
 <a name="json-node-get-array.returns"></a><h4>Returns</h4>
 <p> the <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a>. </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>
+<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>
 </div>
 <hr>
@@ -1374,10 +1375,11 @@ json_node_get_array (<em class="parameter"><code><a class="link" href="json-glib
 <pre class="programlisting"><a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="returnvalue">JsonArray</span></a> *
 json_node_dup_array (<em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
 <p>Retrieves the <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> and returns it
-with its reference count increased by one.</p>
+with its reference count increased by one. If the node does not hold an
+array value, <code class="literal">NULL</code> is returned.</p>
 <div class="refsect3">
 <a name="json-node-dup-array.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1394,7 +1396,7 @@ with its reference count increased by one.</p>
 <a name="json-node-dup-array.returns"></a><h4>Returns</h4>
 <p> the <a class="link" href="json-glib-JSON-Array.html#JsonArray"><span class="type">JsonArray</span></a> with its reference
 count increased. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</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>
 </div>
 <hr>
@@ -1412,7 +1414,7 @@ json_node_set_object (<em class="parameter"><code><a class="link" href="json-gli
 <p>It is an error to call this on an immutable node.</p>
 <div class="refsect3">
 <a name="json-node-set-object.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1446,7 +1448,7 @@ json_node_take_object (<em class="parameter"><code><a class="link" href="json-gl
 <p>It is an error to call this on an immutable node.</p>
 <div class="refsect3">
 <a name="json-node-take-object.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1472,10 +1474,11 @@ json_node_take_object (<em class="parameter"><code><a class="link" href="json-gl
 <a name="json-node-get-object"></a><h3>json_node_get_object ()</h3>
 <pre class="programlisting"><a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="returnvalue">JsonObject</span></a> *
 json_node_get_object (<em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
-<p>Retrieves the <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a></p>
+<p>Retrieves the <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a>. If the node does not
+hold an object value, <code class="literal">NULL</code> is returned.</p>
 <div class="refsect3">
 <a name="json-node-get-object.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1491,7 +1494,7 @@ json_node_get_object (<em class="parameter"><code><a class="link" href="json-gli
 <div class="refsect3">
 <a name="json-node-get-object.returns"></a><h4>Returns</h4>
 <p> the <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a>. </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>
+<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>
 </div>
 <hr>
@@ -1501,10 +1504,11 @@ json_node_get_object (<em class="parameter"><code><a class="link" href="json-gli
 json_node_dup_object (<em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
 <p>Retrieves the <a class="link" href="json-glib-JSON-Object.html#JsonObject"><span class="type">JsonObject</span></a> inside <em class="parameter"><code>node</code></em>
 . The reference count of
-the returned object is increased.</p>
+the returned object is increased. If the node does not hold an object value,
+<code class="literal">NULL</code> is returned.</p>
 <div class="refsect3">
 <a name="json-node-dup-object.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1520,7 +1524,7 @@ the returned object is increased.</p>
 <div class="refsect3">
 <a name="json-node-dup-object.returns"></a><h4>Returns</h4>
 <p> the <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>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</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>
 </div>
 <hr>
@@ -1535,7 +1539,7 @@ json_node_set_value (<em class="parameter"><code><a class="link" href="json-glib
 <p>It is an error to call this on an immutable node.</p>
 <div class="refsect3">
 <a name="json-node-set-value.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1564,10 +1568,12 @@ json_node_get_value (<em class="parameter"><code><a class="link" href="json-glib
                      <em class="parameter"><code><span class="type">GValue</span> *value</code></em>);</pre>
 <p>Retrieves a value from a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> and copies into <em class="parameter"><code>value</code></em>
 . When done
-using it, call <code class="function">g_value_unset()</code> on the <span class="type">GValue</span>.</p>
+using it, call <code class="function">g_value_unset()</code> on the <span class="type">GValue</span>. If the node does not hold a
+scalar value, <em class="parameter"><code>value</code></em>
+ is not modified.</p>
 <div class="refsect3">
 <a name="json-node-get-value.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1601,7 +1607,7 @@ content.</p>
 <p>It is an error to call this on an immutable node.</p>
 <div class="refsect3">
 <a name="json-node-set-boolean.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1627,10 +1633,13 @@ content.</p>
 <a name="json-node-get-boolean"></a><h3>json_node_get_boolean ()</h3>
 <pre class="programlisting"><span class="returnvalue">gboolean</span>
 json_node_get_boolean (<em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
-<p>Gets the boolean value stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a></p>
+<p>Gets the boolean value stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a>. If the node holds an
+integer or double value which is zero, <code class="literal">FALSE</code> is returned; otherwise <code class="literal">TRUE</code>
+is returned. If the node holds a <a class="link" href="json-glib-JSON-Node.html#JSON-NODE-NULL:CAPS"><code class="literal">JSON_NODE_NULL</code></a> value or a value of another
+non-boolean type, <code class="literal">FALSE</code> is returned.</p>
 <div class="refsect3">
 <a name="json-node-get-boolean.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1661,7 +1670,7 @@ content.</p>
 <p>It is an error to call this on an immutable node.</p>
 <div class="refsect3">
 <a name="json-node-set-double.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1687,10 +1696,14 @@ content.</p>
 <a name="json-node-get-double"></a><h3>json_node_get_double ()</h3>
 <pre class="programlisting"><span class="returnvalue">gdouble</span>
 json_node_get_double (<em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
-<p>Gets the double value stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a></p>
+<p>Gets the double value stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a>. If the node holds an integer
+value, it is returned as a double. If the node holds a <code class="literal">FALSE</code> boolean value,
+<code class="literal">0.0</code> is returned; otherwise a non-zero double is returned. If the node holds
+a <a class="link" href="json-glib-JSON-Node.html#JSON-NODE-NULL:CAPS"><code class="literal">JSON_NODE_NULL</code></a> value or a value of another non-double type, <code class="literal">0.0</code> is
+returned.</p>
 <div class="refsect3">
 <a name="json-node-get-double.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1721,7 +1734,7 @@ content.</p>
 <p>It is an error to call this on an immutable node.</p>
 <div class="refsect3">
 <a name="json-node-set-int.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1747,10 +1760,14 @@ content.</p>
 <a name="json-node-get-int"></a><h3>json_node_get_int ()</h3>
 <pre class="programlisting"><span class="returnvalue">gint64</span>
 json_node_get_int (<em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
-<p>Gets the integer value stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a></p>
+<p>Gets the integer value stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a>. If the node holds a double
+value, its integer component is returned. If the node holds a <code class="literal">FALSE</code> boolean
+value, <code class="literal">0</code> is returned; otherwise a non-zero integer is returned. If the
+node holds a <a class="link" href="json-glib-JSON-Node.html#JSON-NODE-NULL:CAPS"><code class="literal">JSON_NODE_NULL</code></a> value or a value of another non-integer type,
+<code class="literal">0</code> is returned.</p>
 <div class="refsect3">
 <a name="json-node-get-int.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1781,7 +1798,7 @@ content.</p>
 <p>It is an error to call this on an immutable node.</p>
 <div class="refsect3">
 <a name="json-node-set-string.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1807,10 +1824,11 @@ content.</p>
 <a name="json-node-get-string"></a><h3>json_node_get_string ()</h3>
 <pre class="programlisting">const <span class="returnvalue">gchar</span> *
 json_node_get_string (<em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
-<p>Gets the string value stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a></p>
+<p>Gets the string value stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a>. If the node does not hold a
+string value, <code class="literal">NULL</code> is returned.</p>
 <div class="refsect3">
 <a name="json-node-get-string.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1825,7 +1843,8 @@ json_node_get_string (<em class="parameter"><code><a class="link" href="json-gli
 </div>
 <div class="refsect3">
 <a name="json-node-get-string.returns"></a><h4>Returns</h4>
-<p> a string value.</p>
+<p> a string value. </p>
+<p><span class="annotation">[<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>
 </div>
 <hr>
@@ -1833,10 +1852,11 @@ json_node_get_string (<em class="parameter"><code><a class="link" href="json-gli
 <a name="json-node-dup-string"></a><h3>json_node_dup_string ()</h3>
 <pre class="programlisting"><span class="returnvalue">gchar</span> *
 json_node_dup_string (<em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
-<p>Gets a copy of the string value stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a></p>
+<p>Gets a copy of the string value stored inside a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a>. If the node does
+not hold a string value, <code class="literal">NULL</code> is returned.</p>
 <div class="refsect3">
 <a name="json-node-dup-string.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1851,9 +1871,10 @@ json_node_dup_string (<em class="parameter"><code><a class="link" href="json-gli
 </div>
 <div class="refsect3">
 <a name="json-node-dup-string.returns"></a><h4>Returns</h4>
-<p> a newly allocated string containing a copy
-of the <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> contents. Use <code class="function">g_free()</code> to free the allocated resources. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p> a newly allocated string
+containing a copy of the <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a> contents. Use <code class="function">g_free()</code> to free the
+allocated resources. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</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>
 </div>
 <hr>
@@ -1870,7 +1891,7 @@ json_node_set_parent (<em class="parameter"><code><a class="link" href="json-gli
 immutable.</p>
 <div class="refsect3">
 <a name="json-node-set-parent.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1902,7 +1923,7 @@ json_node_get_parent (<em class="parameter"><code><a class="link" href="json-gli
 .</p>
 <div class="refsect3">
 <a name="json-node-get-parent.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1918,9 +1939,8 @@ json_node_get_parent (<em class="parameter"><code><a class="link" href="json-gli
 <div class="refsect3">
 <a name="json-node-get-parent.returns"></a><h4>Returns</h4>
 <p> the parent node, or <code class="literal">NULL</code> if <em class="parameter"><code>node</code></em>
-is
-the root node. </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>
+is the root node. </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>
 </div>
 <hr>
@@ -1932,7 +1952,7 @@ json_node_type_name (<em class="parameter"><code><a class="link" href="json-glib
 .</p>
 <div class="refsect3">
 <a name="json-node-type-name.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1959,7 +1979,7 @@ json_node_get_value_type (<em class="parameter"><code><a class="link" href="json
 <p>Returns the <span class="type">GType</span> of the payload of the node.</p>
 <div class="refsect3">
 <a name="json-node-get-value-type.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1987,7 +2007,7 @@ json_node_get_node_type (<em class="parameter"><code><a class="link" href="json-
 </p>
 <div class="refsect3">
 <a name="json-node-get-node-type.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2017,7 +2037,7 @@ json_node_is_null (<em class="parameter"><code><a class="link" href="json-glib-J
 <a class="link" href="json-glib-JSON-Node.html#JSON-NODE-NULL:CAPS"><code class="literal">JSON_NODE_NULL</code></a> represents a 'null' value in the JSON tree.</p>
 <div class="refsect3">
 <a name="json-node-is-null.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2048,7 +2068,7 @@ decomposition or normalisation. This is not explicitly mentioned in the JSON
 standard (ECMA-404), but is assumed.</p>
 <div class="refsect3">
 <a name="json-string-hash.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2079,7 +2099,7 @@ json_string_equal (<em class="parameter"><code><span class="type">gconstpointer<
  are equal UTF-8 JSON strings.</p>
 <div class="refsect3">
 <a name="json-string-equal.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2119,7 +2139,7 @@ json_string_compare (<em class="parameter"><code><span class="type">gconstpointe
 over them in <code class="function">strcmp()</code> style.</p>
 <div class="refsect3">
 <a name="json-string-compare.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2160,7 +2180,7 @@ greater than zero if <em class="parameter"><code>a</code></em>
 <p>Indicates the content of a <a class="link" href="json-glib-JSON-Node.html#JsonNode"><span class="type">JsonNode</span></a>.</p>
 <div class="refsect3">
 <a name="JsonNodeType.members"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="enum_members_name">
 <col class="enum_members_description">
@@ -2210,6 +2230,6 @@ functions and never directly.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25</div>
+<hr>Generated by GTK-Doc V1.25.1</div>
 </body>
 </html>
\ No newline at end of file