1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>JSON Object</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="JSON-GLib Reference Manual">
8 <link rel="up" href="ch01.html" title="Data Types">
9 <link rel="prev" href="json-glib-JSON-Array.html" title="JSON Array">
10 <link rel="next" href="json-streams.html" title="Part III. Reading and writing">
11 <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17 <td><a accesskey="p" href="json-glib-JSON-Array.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">JSON-GLib Reference Manual</th>
21 <td><a accesskey="n" href="json-streams.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#json-glib-JSON-Object.synopsis" class="shortcut">Top</a>
26 <a href="#json-glib-JSON-Object.description" class="shortcut">Description</a>
29 <div class="refentry">
30 <a name="json-glib-JSON-Object"></a><div class="titlepage"></div>
31 <div class="refnamediv"><table width="100%"><tr>
33 <h2><span class="refentrytitle"><a name="json-glib-JSON-Object.top_of_page"></a>JSON Object</span></h2>
34 <p>JSON Object — a JSON object representation</p>
36 <td valign="top" align="right"></td>
38 <div class="refsynopsisdiv">
39 <a name="json-glib-JSON-Object.synopsis"></a><h2>Synopsis</h2>
40 <pre class="synopsis"> <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject">JsonObject</a>;
41 <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="returnvalue">JsonObject</span></a> * <a class="link" href="json-glib-JSON-Object.html#json-object-new" title="json_object_new ()">json_object_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
42 <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="returnvalue">JsonObject</span></a> * <a class="link" href="json-glib-JSON-Object.html#json-object-ref" title="json_object_ref ()">json_object_ref</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);
43 <span class="returnvalue">void</span> <a class="link" href="json-glib-JSON-Object.html#json-object-unref" title="json_object_unref ()">json_object_unref</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);
45 <span class="returnvalue">void</span> <a class="link" href="json-glib-JSON-Object.html#json-object-add-member" title="json_object_add_member ()">json_object_add_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
46 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
47 <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);
48 <span class="returnvalue">void</span> <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()">json_object_set_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
49 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
50 <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);
51 <span class="returnvalue">gboolean</span> <a class="link" href="json-glib-JSON-Object.html#json-object-has-member" title="json_object_has_member ()">json_object_has_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
52 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
53 <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> * <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()">json_object_get_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
54 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
55 <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> * <a class="link" href="json-glib-JSON-Object.html#json-object-dup-member" title="json_object_dup_member ()">json_object_dup_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
56 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
57 <span class="returnvalue">GList</span> * <a class="link" href="json-glib-JSON-Object.html#json-object-get-members" title="json_object_get_members ()">json_object_get_members</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);
58 <span class="returnvalue">GList</span> * <a class="link" href="json-glib-JSON-Object.html#json-object-get-values" title="json_object_get_values ()">json_object_get_values</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);
59 <span class="returnvalue">guint</span> <a class="link" href="json-glib-JSON-Object.html#json-object-get-size" title="json_object_get_size ()">json_object_get_size</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);
60 <span class="returnvalue">void</span> <a class="link" href="json-glib-JSON-Object.html#json-object-remove-member" title="json_object_remove_member ()">json_object_remove_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
61 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
62 <span class="returnvalue">void</span> (<a class="link" href="json-glib-JSON-Object.html#JsonObjectForeach" title="JsonObjectForeach ()">*JsonObjectForeach</a>) (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
63 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
64 <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *member_node</code></em>,
65 <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
66 <span class="returnvalue">void</span> <a class="link" href="json-glib-JSON-Object.html#json-object-foreach-member" title="json_object_foreach_member ()">json_object_foreach_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
67 <em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObjectForeach" title="JsonObjectForeach ()"><span class="type">JsonObjectForeach</span></a> func</code></em>,
68 <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
70 <span class="returnvalue">void</span> <a class="link" href="json-glib-JSON-Object.html#json-object-set-array-member" title="json_object_set_array_member ()">json_object_set_array_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
71 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
72 <em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray" title="JsonArray"><span class="type">JsonArray</span></a> *value</code></em>);
73 <a class="link" href="json-glib-JSON-Array.html#JsonArray" title="JsonArray"><span class="returnvalue">JsonArray</span></a> * <a class="link" href="json-glib-JSON-Object.html#json-object-get-array-member" title="json_object_get_array_member ()">json_object_get_array_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
74 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
75 <span class="returnvalue">void</span> <a class="link" href="json-glib-JSON-Object.html#json-object-set-boolean-member" title="json_object_set_boolean_member ()">json_object_set_boolean_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
76 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
77 <em class="parameter"><code><span class="type">gboolean</span> value</code></em>);
78 <span class="returnvalue">gboolean</span> <a class="link" href="json-glib-JSON-Object.html#json-object-get-boolean-member" title="json_object_get_boolean_member ()">json_object_get_boolean_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
79 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
80 <span class="returnvalue">void</span> <a class="link" href="json-glib-JSON-Object.html#json-object-set-double-member" title="json_object_set_double_member ()">json_object_set_double_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
81 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
82 <em class="parameter"><code><span class="type">gdouble</span> value</code></em>);
83 <span class="returnvalue">gdouble</span> <a class="link" href="json-glib-JSON-Object.html#json-object-get-double-member" title="json_object_get_double_member ()">json_object_get_double_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
84 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
85 <span class="returnvalue">void</span> <a class="link" href="json-glib-JSON-Object.html#json-object-set-int-member" title="json_object_set_int_member ()">json_object_set_int_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
86 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
87 <em class="parameter"><code><span class="type">gint64</span> value</code></em>);
88 <span class="returnvalue">gint64</span> <a class="link" href="json-glib-JSON-Object.html#json-object-get-int-member" title="json_object_get_int_member ()">json_object_get_int_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
89 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
90 <span class="returnvalue">void</span> <a class="link" href="json-glib-JSON-Object.html#json-object-set-null-member" title="json_object_set_null_member ()">json_object_set_null_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
91 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
92 <span class="returnvalue">gboolean</span> <a class="link" href="json-glib-JSON-Object.html#json-object-get-null-member" title="json_object_get_null_member ()">json_object_get_null_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
93 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
94 <span class="returnvalue">void</span> <a class="link" href="json-glib-JSON-Object.html#json-object-set-object-member" title="json_object_set_object_member ()">json_object_set_object_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
95 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
96 <em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *value</code></em>);
97 <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="returnvalue">JsonObject</span></a> * <a class="link" href="json-glib-JSON-Object.html#json-object-get-object-member" title="json_object_get_object_member ()">json_object_get_object_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
98 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
99 <span class="returnvalue">void</span> <a class="link" href="json-glib-JSON-Object.html#json-object-set-string-member" title="json_object_set_string_member ()">json_object_set_string_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
100 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
101 <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);
102 const <span class="returnvalue">gchar</span> * <a class="link" href="json-glib-JSON-Object.html#json-object-get-string-member" title="json_object_get_string_member ()">json_object_get_string_member</a> (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
103 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);
106 <div class="refsect1">
107 <a name="json-glib-JSON-Object.description"></a><h2>Description</h2>
109 <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> is the representation of the object type inside JSON. It contains
110 <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a>s, which may contain fundamental types, arrays or other
111 objects. Each member of an object is accessed using its name.
114 Since objects can be expensive, they are reference counted. You can control
115 the lifetime of a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> using <a class="link" href="json-glib-JSON-Object.html#json-object-ref" title="json_object_ref ()"><code class="function">json_object_ref()</code></a> and <a class="link" href="json-glib-JSON-Object.html#json-object-unref" title="json_object_unref ()"><code class="function">json_object_unref()</code></a>.
118 To add or overwrite a member with a given name, use <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>.
119 To extract a member with a given name, use <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>.
120 To retrieve the list of members, use <a class="link" href="json-glib-JSON-Object.html#json-object-get-members" title="json_object_get_members ()"><code class="function">json_object_get_members()</code></a>.
121 To retrieve the size of the object (that is, the number of members it has),
122 use <a class="link" href="json-glib-JSON-Object.html#json-object-get-size" title="json_object_get_size ()"><code class="function">json_object_get_size()</code></a>.
125 <div class="refsect1">
126 <a name="json-glib-JSON-Object.details"></a><h2>Details</h2>
127 <div class="refsect2">
128 <a name="JsonObject"></a><h3>JsonObject</h3>
129 <pre class="programlisting">typedef struct _JsonObject JsonObject;</pre>
131 A JSON object type. The contents of the <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> structure are private
132 and should only be accessed by the provided API
136 <div class="refsect2">
137 <a name="json-object-new"></a><h3>json_object_new ()</h3>
138 <pre class="programlisting"><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="returnvalue">JsonObject</span></a> * json_object_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
140 Creates a new <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>, an JSON object type representation.
142 <div class="variablelist"><table border="0">
143 <col align="left" valign="top">
145 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
146 <td>the newly created <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
152 <div class="refsect2">
153 <a name="json-object-ref"></a><h3>json_object_ref ()</h3>
154 <pre class="programlisting"><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="returnvalue">JsonObject</span></a> * json_object_ref (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
156 Increase by one the reference count of a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>.
158 <div class="variablelist"><table border="0">
159 <col align="left" valign="top">
162 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
163 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
167 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
168 <td>the passed <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>, with the reference count
169 increased by one.</td>
175 <div class="refsect2">
176 <a name="json-object-unref"></a><h3>json_object_unref ()</h3>
177 <pre class="programlisting"><span class="returnvalue">void</span> json_object_unref (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
179 Decreases by one the reference count of a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>. If the
180 reference count reaches zero, the object is destroyed and all
181 its allocated resources are freed.
183 <div class="variablelist"><table border="0">
184 <col align="left" valign="top">
186 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
187 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
193 <div class="refsect2">
194 <a name="json-object-add-member"></a><h3>json_object_add_member ()</h3>
195 <pre class="programlisting"><span class="returnvalue">void</span> json_object_add_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
196 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
197 <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
198 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
199 <h3 class="title">Warning</h3>
200 <p><code class="literal">json_object_add_member</code> has been deprecated since version 0.8 and should not be used in newly-written code. Use <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a> instead</p>
203 Adds a member named <em class="parameter"><code>member_name</code></em> and containing <em class="parameter"><code>node</code></em> into a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>.
204 The object will take ownership of the <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a>.
207 This function will return if the <em class="parameter"><code>object</code></em> already contains a member
208 <em class="parameter"><code>member_name</code></em>.
210 <div class="variablelist"><table border="0">
211 <col align="left" valign="top">
214 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
215 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
219 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
220 <td>the name of the member</td>
223 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
224 <td>the value of the member. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
231 <div class="refsect2">
232 <a name="json-object-set-member"></a><h3>json_object_set_member ()</h3>
233 <pre class="programlisting"><span class="returnvalue">void</span> json_object_set_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
234 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
235 <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *node</code></em>);</pre>
237 Sets <em class="parameter"><code>node</code></em> as the value of <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
240 If <em class="parameter"><code>object</code></em> already contains a member called <em class="parameter"><code>member_name</code></em> then
241 the member's current value is overwritten. Otherwise, a new
242 member is added to <em class="parameter"><code>object</code></em>.
244 <div class="variablelist"><table border="0">
245 <col align="left" valign="top">
248 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
249 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
253 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
254 <td>the name of the member</td>
257 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
258 <td>the value of the member. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
263 <p class="since">Since 0.8</p>
266 <div class="refsect2">
267 <a name="json-object-has-member"></a><h3>json_object_has_member ()</h3>
268 <pre class="programlisting"><span class="returnvalue">gboolean</span> json_object_has_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
269 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
271 Checks whether <em class="parameter"><code>object</code></em> has a member named <em class="parameter"><code>member_name</code></em>.
273 <div class="variablelist"><table border="0">
274 <col align="left" valign="top">
277 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
278 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
282 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
283 <td>the name of a JSON object member</td>
286 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
288 <code class="literal">TRUE</code> if the JSON object has the requested member</td>
294 <div class="refsect2">
295 <a name="json-object-get-member"></a><h3>json_object_get_member ()</h3>
296 <pre class="programlisting"><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> * json_object_get_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
297 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
299 Retrieves the <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> containing the value of <em class="parameter"><code>member_name</code></em> inside
300 a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>.
302 <div class="variablelist"><table border="0">
303 <col align="left" valign="top">
306 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
307 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
311 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
312 <td>the name of the JSON object member to access</td>
315 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
316 <td>a pointer to the node for the requested object
317 member, or <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
324 <div class="refsect2">
325 <a name="json-object-dup-member"></a><h3>json_object_dup_member ()</h3>
326 <pre class="programlisting"><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> * json_object_dup_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
327 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
329 Retrieves a copy of the <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> containing the value of <em class="parameter"><code>member_name</code></em>
330 inside a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
332 <div class="variablelist"><table border="0">
333 <col align="left" valign="top">
336 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
337 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
341 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
342 <td>the name of the JSON object member to access</td>
345 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
346 <td>a copy of the node for the requested
347 object member or <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. Use <a class="link" href="json-glib-JSON-Node.html#json-node-free" title="json_node_free ()"><code class="function">json_node_free()</code></a> when done. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
352 <p class="since">Since 0.6</p>
355 <div class="refsect2">
356 <a name="json-object-get-members"></a><h3>json_object_get_members ()</h3>
357 <pre class="programlisting"><span class="returnvalue">GList</span> * json_object_get_members (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
359 Retrieves all the names of the members of a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>. You can
360 obtain the value for each member using <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>.
362 <div class="variablelist"><table border="0">
363 <col align="left" valign="top">
366 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
367 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
371 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
372 <td>a <span class="type">GList</span>
373 of member names. The content of the list is owned by the <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
374 and should never be modified or freed. When you have finished using
375 the returned list, use <code class="function">g_list_free()</code> to free the resources it has
376 allocated. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
383 <div class="refsect2">
384 <a name="json-object-get-values"></a><h3>json_object_get_values ()</h3>
385 <pre class="programlisting"><span class="returnvalue">GList</span> * json_object_get_values (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
387 Retrieves all the values of the members of a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>.
389 <div class="variablelist"><table border="0">
390 <col align="left" valign="top">
393 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
394 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
398 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
399 <td>a <span class="type">GList</span> of
400 <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a>s. The content of the list is owned by the <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
401 and should never be modified or freed. When you have finished using the
402 returned list, use <code class="function">g_list_free()</code> to free the resources it has allocated. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> JsonNode][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
409 <div class="refsect2">
410 <a name="json-object-get-size"></a><h3>json_object_get_size ()</h3>
411 <pre class="programlisting"><span class="returnvalue">guint</span> json_object_get_size (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>);</pre>
413 Retrieves the number of members of a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>.
415 <div class="variablelist"><table border="0">
416 <col align="left" valign="top">
419 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
420 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
424 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
425 <td>the number of members</td>
431 <div class="refsect2">
432 <a name="json-object-remove-member"></a><h3>json_object_remove_member ()</h3>
433 <pre class="programlisting"><span class="returnvalue">void</span> json_object_remove_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
434 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
436 Removes <em class="parameter"><code>member_name</code></em> from <em class="parameter"><code>object</code></em>, freeing its allocated resources.
438 <div class="variablelist"><table border="0">
439 <col align="left" valign="top">
442 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
443 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
447 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
448 <td>the name of the member to remove</td>
454 <div class="refsect2">
455 <a name="JsonObjectForeach"></a><h3>JsonObjectForeach ()</h3>
456 <pre class="programlisting"><span class="returnvalue">void</span> (*JsonObjectForeach) (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
457 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
458 <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *member_node</code></em>,
459 <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
461 The function to be passed to <a class="link" href="json-glib-JSON-Object.html#json-object-foreach-member" title="json_object_foreach_member ()"><code class="function">json_object_foreach_member()</code></a>. You
462 should not add or remove members to and from <em class="parameter"><code>object</code></em> within
463 this function. It is safe to change the value of <em class="parameter"><code>member_node</code></em>.
465 <div class="variablelist"><table border="0">
466 <col align="left" valign="top">
469 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
470 <td>the iterated <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
474 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
475 <td>the name of the member</td>
478 <td><p><span class="term"><em class="parameter"><code>member_node</code></em> :</span></p></td>
479 <td>a <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> containing the <em class="parameter"><code>member_name</code></em> value</td>
482 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
483 <td>data passed to the function</td>
487 <p class="since">Since 0.8</p>
490 <div class="refsect2">
491 <a name="json-object-foreach-member"></a><h3>json_object_foreach_member ()</h3>
492 <pre class="programlisting"><span class="returnvalue">void</span> json_object_foreach_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
493 <em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObjectForeach" title="JsonObjectForeach ()"><span class="type">JsonObjectForeach</span></a> func</code></em>,
494 <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
496 Iterates over all members of <em class="parameter"><code>object</code></em> and calls <em class="parameter"><code>func</code></em> on
500 It is safe to change the value of a <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> of the <em class="parameter"><code>object</code></em>
501 from within the iterator <em class="parameter"><code>func</code></em>, but it is not safe to add or
502 remove members from the <em class="parameter"><code>object</code></em>.
504 <div class="variablelist"><table border="0">
505 <col align="left" valign="top">
508 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
509 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
513 <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
514 <td>the function to be called on each member. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
518 <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
519 <td>data to be passed to the function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
524 <p class="since">Since 0.8</p>
527 <div class="refsect2">
528 <a name="json-object-set-array-member"></a><h3>json_object_set_array_member ()</h3>
529 <pre class="programlisting"><span class="returnvalue">void</span> json_object_set_array_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
530 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
531 <em class="parameter"><code><a class="link" href="json-glib-JSON-Array.html#JsonArray" title="JsonArray"><span class="type">JsonArray</span></a> *value</code></em>);</pre>
533 Convenience function for setting an array <em class="parameter"><code>value</code></em> of
534 <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
537 The <em class="parameter"><code>object</code></em> will take ownership of the passed <a class="link" href="json-glib-JSON-Array.html#JsonArray" title="JsonArray"><span class="type">JsonArray</span></a>
540 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
542 <div class="variablelist"><table border="0">
543 <col align="left" valign="top">
546 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
547 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
551 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
552 <td>the name of the member</td>
555 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
556 <td>the value of the member. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
561 <p class="since">Since 0.8</p>
564 <div class="refsect2">
565 <a name="json-object-get-array-member"></a><h3>json_object_get_array_member ()</h3>
566 <pre class="programlisting"><a class="link" href="json-glib-JSON-Array.html#JsonArray" title="JsonArray"><span class="returnvalue">JsonArray</span></a> * json_object_get_array_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
567 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
569 Convenience function that retrieves the array
570 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em>
573 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
575 <div class="variablelist"><table border="0">
576 <col align="left" valign="top">
579 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
580 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
584 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
585 <td>the name of the member</td>
588 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
589 <td>the array inside the object's member. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
594 <p class="since">Since 0.8</p>
597 <div class="refsect2">
598 <a name="json-object-set-boolean-member"></a><h3>json_object_set_boolean_member ()</h3>
599 <pre class="programlisting"><span class="returnvalue">void</span> json_object_set_boolean_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
600 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
601 <em class="parameter"><code><span class="type">gboolean</span> value</code></em>);</pre>
603 Convenience function for setting a boolean <em class="parameter"><code>value</code></em> of
604 <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
607 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
609 <div class="variablelist"><table border="0">
610 <col align="left" valign="top">
613 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
614 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
618 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
619 <td>the name of the member</td>
622 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
623 <td>the value of the member</td>
627 <p class="since">Since 0.8</p>
630 <div class="refsect2">
631 <a name="json-object-get-boolean-member"></a><h3>json_object_get_boolean_member ()</h3>
632 <pre class="programlisting"><span class="returnvalue">gboolean</span> json_object_get_boolean_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
633 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
635 Convenience function that retrieves the boolean value
636 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em>
639 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
641 <div class="variablelist"><table border="0">
642 <col align="left" valign="top">
645 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
646 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
650 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
651 <td>the name of the member</td>
654 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
655 <td>the boolean value of the object's member</td>
659 <p class="since">Since 0.8</p>
662 <div class="refsect2">
663 <a name="json-object-set-double-member"></a><h3>json_object_set_double_member ()</h3>
664 <pre class="programlisting"><span class="returnvalue">void</span> json_object_set_double_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
665 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
666 <em class="parameter"><code><span class="type">gdouble</span> value</code></em>);</pre>
668 Convenience function for setting a floating point <em class="parameter"><code>value</code></em>
669 of <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
672 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
674 <div class="variablelist"><table border="0">
675 <col align="left" valign="top">
678 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
679 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
683 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
684 <td>the name of the member</td>
687 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
688 <td>the value of the member</td>
692 <p class="since">Since 0.8</p>
695 <div class="refsect2">
696 <a name="json-object-get-double-member"></a><h3>json_object_get_double_member ()</h3>
697 <pre class="programlisting"><span class="returnvalue">gdouble</span> json_object_get_double_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
698 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
700 Convenience function that retrieves the floating point value
701 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em>
704 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
706 <div class="variablelist"><table border="0">
707 <col align="left" valign="top">
710 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
711 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
715 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
716 <td>the name of the member</td>
719 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
720 <td>the floating point value of the object's member</td>
724 <p class="since">Since 0.8</p>
727 <div class="refsect2">
728 <a name="json-object-set-int-member"></a><h3>json_object_set_int_member ()</h3>
729 <pre class="programlisting"><span class="returnvalue">void</span> json_object_set_int_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
730 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
731 <em class="parameter"><code><span class="type">gint64</span> value</code></em>);</pre>
733 Convenience function for setting an integer <em class="parameter"><code>value</code></em> of
734 <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
737 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
739 <div class="variablelist"><table border="0">
740 <col align="left" valign="top">
743 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
744 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
748 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
749 <td>the name of the member</td>
752 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
753 <td>the value of the member</td>
757 <p class="since">Since 0.8</p>
760 <div class="refsect2">
761 <a name="json-object-get-int-member"></a><h3>json_object_get_int_member ()</h3>
762 <pre class="programlisting"><span class="returnvalue">gint64</span> json_object_get_int_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
763 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
765 Convenience function that retrieves the integer value
766 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em>
769 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
771 <div class="variablelist"><table border="0">
772 <col align="left" valign="top">
775 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
776 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
780 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
781 <td>the name of the member</td>
784 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
785 <td>the integer value of the object's member</td>
789 <p class="since">Since 0.8</p>
792 <div class="refsect2">
793 <a name="json-object-set-null-member"></a><h3>json_object_set_null_member ()</h3>
794 <pre class="programlisting"><span class="returnvalue">void</span> json_object_set_null_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
795 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
797 Convenience function for setting a null <em class="parameter"><code>value</code></em> of
798 <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
801 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
803 <div class="variablelist"><table border="0">
804 <col align="left" valign="top">
807 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
808 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
812 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
813 <td>the name of the member</td>
817 <p class="since">Since 0.8</p>
820 <div class="refsect2">
821 <a name="json-object-get-null-member"></a><h3>json_object_get_null_member ()</h3>
822 <pre class="programlisting"><span class="returnvalue">gboolean</span> json_object_get_null_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
823 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
825 Convenience function that checks whether the value
826 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em> is null
829 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
831 <div class="variablelist"><table border="0">
832 <col align="left" valign="top">
835 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
836 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
840 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
841 <td>the name of the member</td>
844 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
846 <code class="literal">TRUE</code> if the value is null</td>
850 <p class="since">Since 0.8</p>
853 <div class="refsect2">
854 <a name="json-object-set-object-member"></a><h3>json_object_set_object_member ()</h3>
855 <pre class="programlisting"><span class="returnvalue">void</span> json_object_set_object_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
856 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
857 <em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *value</code></em>);</pre>
859 Convenience function for setting an object <em class="parameter"><code>value</code></em> of
860 <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
863 The <em class="parameter"><code>object</code></em> will take ownership of the passed <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
866 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
868 <div class="variablelist"><table border="0">
869 <col align="left" valign="top">
872 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
873 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
877 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
878 <td>the name of the member</td>
881 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
882 <td>the value of the member. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
887 <p class="since">Since 0.8</p>
890 <div class="refsect2">
891 <a name="json-object-get-object-member"></a><h3>json_object_get_object_member ()</h3>
892 <pre class="programlisting"><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="returnvalue">JsonObject</span></a> * json_object_get_object_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
893 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
895 Convenience function that retrieves the object
896 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em>
899 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
901 <div class="variablelist"><table border="0">
902 <col align="left" valign="top">
905 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
906 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
910 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
911 <td>the name of the member</td>
914 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
915 <td>the object inside the object's member. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
920 <p class="since">Since 0.8</p>
923 <div class="refsect2">
924 <a name="json-object-set-string-member"></a><h3>json_object_set_string_member ()</h3>
925 <pre class="programlisting"><span class="returnvalue">void</span> json_object_set_string_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
926 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>,
927 <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
929 Convenience function for setting a string <em class="parameter"><code>value</code></em> of
930 <em class="parameter"><code>member_name</code></em> inside <em class="parameter"><code>object</code></em>.
933 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-set-member" title="json_object_set_member ()"><code class="function">json_object_set_member()</code></a>
935 <div class="variablelist"><table border="0">
936 <col align="left" valign="top">
939 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
940 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
944 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
945 <td>the name of the member</td>
948 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
949 <td>the value of the member</td>
953 <p class="since">Since 0.8</p>
956 <div class="refsect2">
957 <a name="json-object-get-string-member"></a><h3>json_object_get_string_member ()</h3>
958 <pre class="programlisting">const <span class="returnvalue">gchar</span> * json_object_get_string_member (<em class="parameter"><code><a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a> *object</code></em>,
959 <em class="parameter"><code>const <span class="type">gchar</span> *member_name</code></em>);</pre>
961 Convenience function that retrieves the string value
962 stored in <em class="parameter"><code>member_name</code></em> of <em class="parameter"><code>object</code></em>
965 See also: <a class="link" href="json-glib-JSON-Object.html#json-object-get-member" title="json_object_get_member ()"><code class="function">json_object_get_member()</code></a>
967 <div class="variablelist"><table border="0">
968 <col align="left" valign="top">
971 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
972 <td>a <a class="link" href="json-glib-JSON-Object.html#JsonObject" title="JsonObject"><span class="type">JsonObject</span></a>
976 <td><p><span class="term"><em class="parameter"><code>member_name</code></em> :</span></p></td>
977 <td>the name of the member</td>
980 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
981 <td>the string value of the object's member</td>
985 <p class="since">Since 0.8</p>
991 Generated by GTK-Doc V1.18.1</div>