doc/reference/html/json-glib-Serializable-Interface.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Serializable Interface</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="json-advanced.html" title="Part IV. JSON-GLib Advanced API">
   9 <link rel="prev" href="json-glib-GObject-Serialization.html" title="GObject Serialization">
  10 <link rel="next" href="json-glib-Boxed-Types-Serialization.html" title="Boxed Types Serialization">
  11 <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="json-glib-GObject-Serialization.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="json-advanced.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-glib-Boxed-Types-Serialization.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#json-glib-Serializable-Interface.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#json-glib-Serializable-Interface.description" class="shortcut">Description</a>
  27 </td></tr>
  28 </table>
  29 <div class="refentry">
  30 <a name="json-glib-Serializable-Interface"></a><div class="titlepage"></div>
  31 <div class="refnamediv"><table width="100%"><tr>
  32 <td valign="top">
  33 <h2><span class="refentrytitle"><a name="json-glib-Serializable-Interface.top_of_page"></a>Serializable Interface</span></h2>
  34 <p>Serializable Interface — Interface for serialize and deserialize special GObjects</p>
  35 </td>
  36 <td valign="top" align="right"></td>
  37 </tr></table></div>
  38 <div class="refsynopsisdiv">
  39 <a name="json-glib-Serializable-Interface.synopsis"></a><h2>Synopsis</h2>
  40 <pre class="synopsis">struct              <a class="link" href="json-glib-Serializable-Interface.html#JsonSerializableIface" title="struct JsonSerializableIface">JsonSerializableIface</a>;
  41 <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> *          <a class="link" href="json-glib-Serializable-Interface.html#json-serializable-serialize-property" title="json_serializable_serialize_property ()">json_serializable_serialize_property</a>
  42                                                         (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
  43                                                          <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
  44                                                          <em class="parameter"><code>const <span class="type">GValue</span> *value</code></em>,
  45                                                          <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>);
  46 <span class="returnvalue">gboolean</span>            <a class="link" href="json-glib-Serializable-Interface.html#json-serializable-deserialize-property" title="json_serializable_deserialize_property ()">json_serializable_deserialize_property</a>
  47                                                         (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
  48                                                          <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
  49                                                          <em class="parameter"><code><span class="type">GValue</span> *value</code></em>,
  50                                                          <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>,
  51                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *property_node</code></em>);
  52 <span class="returnvalue">GParamSpec</span> *        <a class="link" href="json-glib-Serializable-Interface.html#json-serializable-find-property" title="json_serializable_find_property ()">json_serializable_find_property</a>     (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
  53                                                          <em class="parameter"><code>const <span class="type">char</span> *name</code></em>);
  54 <span class="returnvalue">void</span>                <a class="link" href="json-glib-Serializable-Interface.html#json-serializable-get-property" title="json_serializable_get_property ()">json_serializable_get_property</a>      (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
  55                                                          <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>,
  56                                                          <em class="parameter"><code><span class="type">GValue</span> *value</code></em>);
  57 <span class="returnvalue">GParamSpec</span> **       <a class="link" href="json-glib-Serializable-Interface.html#json-serializable-list-properties" title="json_serializable_list_properties ()">json_serializable_list_properties</a>   (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
  58                                                          <em class="parameter"><code><span class="type">guint</span> *n_pspecs</code></em>);
  59 <span class="returnvalue">void</span>                <a class="link" href="json-glib-Serializable-Interface.html#json-serializable-set-property" title="json_serializable_set_property ()">json_serializable_set_property</a>      (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
  60                                                          <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>,
  61                                                          <em class="parameter"><code>const <span class="type">GValue</span> *value</code></em>);
  62
  63 <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> *          <a class="link" href="json-glib-Serializable-Interface.html#json-serializable-default-serialize-property" title="json_serializable_default_serialize_property ()">json_serializable_default_serialize_property</a>
  64                                                         (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
  65                                                          <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
  66                                                          <em class="parameter"><code>const <span class="type">GValue</span> *value</code></em>,
  67                                                          <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>);
  68 <span class="returnvalue">gboolean</span>            <a class="link" href="json-glib-Serializable-Interface.html#json-serializable-default-deserialize-property" title="json_serializable_default_deserialize_property ()">json_serializable_default_deserialize_property</a>
  69                                                         (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
  70                                                          <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
  71                                                          <em class="parameter"><code><span class="type">GValue</span> *value</code></em>,
  72                                                          <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>,
  73                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *property_node</code></em>);
  74 </pre>
  75 </div>
  76 <div class="refsect1">
  77 <a name="json-glib-Serializable-Interface.description"></a><h2>Description</h2>
  78 <p>
  79 <span class="type">JsonSerializable</span> is an interface for <span class="type">GObject</span> classes that
  80 allows controlling how the class is going to be serialized
  81 or deserialized by <a class="link" href="json-glib-GObject-Serialization.html#json-construct-gobject" title="json_construct_gobject ()"><code class="function">json_construct_gobject()</code></a> and
  82 <a class="link" href="json-glib-GObject-Serialization.html#json-serialize-gobject" title="json_serialize_gobject ()"><code class="function">json_serialize_gobject()</code></a> respectively.
  83 </p>
  84 </div>
  85 <div class="refsect1">
  86 <a name="json-glib-Serializable-Interface.details"></a><h2>Details</h2>
  87 <div class="refsect2">
  88 <a name="JsonSerializableIface"></a><h3>struct JsonSerializableIface</h3>
  89 <pre class="programlisting">struct JsonSerializableIface {
  90   JsonNode *(* serialize_property)   (JsonSerializable *serializable,
  91                                       const gchar      *property_name,
  92                                       const GValue     *value,
  93                                       GParamSpec       *pspec);
  94   gboolean  (* deserialize_property) (JsonSerializable *serializable,
  95                                       const gchar      *property_name,
  96                                       GValue           *value,
  97                                       GParamSpec       *pspec,
  98                                       JsonNode         *property_node);
  99
 100   GParamSpec * (* find_property)       (JsonSerializable *serializable,
 101                                         const char       *name);
 102   GParamSpec **(* list_properties)     (JsonSerializable *serializable,
 103                                         guint            *n_pspecs);
 104   void         (* set_property)        (JsonSerializable *serializable,
 105                                         GParamSpec       *pspec,
 106                                         const GValue     *value);
 107   void         (* get_property)        (JsonSerializable *serializable,
 108                                         GParamSpec       *pspec,
 109                                         GValue           *value);
 110 };
 111 </pre>
 112 <p>
 113 Interface that allows serializing and deserializing <span class="type">GObject</span>s
 114 with properties storing complex data types. The <a class="link" href="json-glib-GObject-Serialization.html#json-serialize-gobject" title="json_serialize_gobject ()"><code class="function">json_serialize_gobject()</code></a>
 115 function will check if the passed <span class="type">GObject</span> implements this interface,
 116 so it can also be used to override the default property serialization
 117 sequence.
 118 </p>
 119 <div class="variablelist"><table border="0">
 120 <col align="left" valign="top">
 121 <tbody>
 122 <tr>
 123 <td><p><span class="term"><em class="structfield"><code><a name="JsonSerializableIface.serialize-property"></a>serialize_property</code></em> ()</span></p></td>
 124 <td>virtual function for serializing a <span class="type">GObject</span> property
 125 into a <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a>
 126 </td>
 127 </tr>
 128 <tr>
 129 <td><p><span class="term"><em class="structfield"><code><a name="JsonSerializableIface.deserialize-property"></a>deserialize_property</code></em> ()</span></p></td>
 130 <td>virtual function for deserializing a <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a>
 131 into a <span class="type">GObject</span> property</td>
 132 </tr>
 133 <tr>
 134 <td><p><span class="term"><em class="structfield"><code><a name="JsonSerializableIface.find-property"></a>find_property</code></em> ()</span></p></td>
 135 <td>virtual function for finding a property definition using
 136 its name</td>
 137 </tr>
 138 <tr>
 139 <td><p><span class="term"><em class="structfield"><code><a name="JsonSerializableIface.list-properties"></a>list_properties</code></em> ()</span></p></td>
 140 <td>virtual function for listing the installed property
 141 definitions</td>
 142 </tr>
 143 <tr>
 144 <td><p><span class="term"><em class="structfield"><code><a name="JsonSerializableIface.set-property"></a>set_property</code></em> ()</span></p></td>
 145 <td>virtual function for setting a property</td>
 146 </tr>
 147 <tr>
 148 <td><p><span class="term"><em class="structfield"><code><a name="JsonSerializableIface.get-property"></a>get_property</code></em> ()</span></p></td>
 149 <td>virtual function for getting a property</td>
 150 </tr>
 151 </tbody>
 152 </table></div>
 153 </div>
 154 <hr>
 155 <div class="refsect2">
 156 <a name="json-serializable-serialize-property"></a><h3>json_serializable_serialize_property ()</h3>
 157 <pre class="programlisting"><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> *          json_serializable_serialize_property
 158                                                         (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
 159                                                          <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
 160                                                          <em class="parameter"><code>const <span class="type">GValue</span> *value</code></em>,
 161                                                          <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>);</pre>
 162 <p>
 163 Asks a <span class="type">JsonSerializable</span> implementation to serialize a <span class="type">GObject</span>
 164 property into a <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> object.
 165 </p>
 166 <div class="variablelist"><table border="0">
 167 <col align="left" valign="top">
 168 <tbody>
 169 <tr>
 170 <td><p><span class="term"><em class="parameter"><code>serializable</code></em> :</span></p></td>
 171 <td>a <span class="type">JsonSerializable</span> object</td>
 172 </tr>
 173 <tr>
 174 <td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
 175 <td>the name of the property</td>
 176 </tr>
 177 <tr>
 178 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 179 <td>the value of the property</td>
 180 </tr>
 181 <tr>
 182 <td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>
 183 <td>a <span class="type">GParamSpec</span>
 184 </td>
 185 </tr>
 186 <tr>
 187 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 188 <td>a <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> containing the serialized property</td>
 189 </tr>
 190 </tbody>
 191 </table></div>
 192 </div>
 193 <hr>
 194 <div class="refsect2">
 195 <a name="json-serializable-deserialize-property"></a><h3>json_serializable_deserialize_property ()</h3>
 196 <pre class="programlisting"><span class="returnvalue">gboolean</span>            json_serializable_deserialize_property
 197                                                         (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
 198                                                          <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
 199                                                          <em class="parameter"><code><span class="type">GValue</span> *value</code></em>,
 200                                                          <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>,
 201                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *property_node</code></em>);</pre>
 202 <p>
 203 Asks a <span class="type">JsonSerializable</span> implementation to deserialize the
 204 property contained inside <em class="parameter"><code>property_node</code></em> into <em class="parameter"><code>value</code></em>.
 205 </p>
 206 <div class="variablelist"><table border="0">
 207 <col align="left" valign="top">
 208 <tbody>
 209 <tr>
 210 <td><p><span class="term"><em class="parameter"><code>serializable</code></em> :</span></p></td>
 211 <td>a <span class="type">JsonSerializable</span>
 212 </td>
 213 </tr>
 214 <tr>
 215 <td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
 216 <td>the name of the property</td>
 217 </tr>
 218 <tr>
 219 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 220 <td>a pointer to an uninitialized <span class="type">GValue</span>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 221 </td>
 222 </tr>
 223 <tr>
 224 <td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>
 225 <td>a <span class="type">GParamSpec</span>
 226 </td>
 227 </tr>
 228 <tr>
 229 <td><p><span class="term"><em class="parameter"><code>property_node</code></em> :</span></p></td>
 230 <td>a <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> containing the serialized property</td>
 231 </tr>
 232 <tr>
 233 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 234 <td>
 235 <code class="literal">TRUE</code> if the property was successfully deserialized.</td>
 236 </tr>
 237 </tbody>
 238 </table></div>
 239 </div>
 240 <hr>
 241 <div class="refsect2">
 242 <a name="json-serializable-find-property"></a><h3>json_serializable_find_property ()</h3>
 243 <pre class="programlisting"><span class="returnvalue">GParamSpec</span> *        json_serializable_find_property     (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
 244                                                          <em class="parameter"><code>const <span class="type">char</span> *name</code></em>);</pre>
 245 <p>
 246 FIXME
 247 </p>
 248 <div class="variablelist"><table border="0">
 249 <col align="left" valign="top">
 250 <tbody>
 251 <tr>
 252 <td><p><span class="term"><em class="parameter"><code>serializable</code></em> :</span></p></td>
 253 <td>a <span class="type">JsonSerializable</span>
 254 </td>
 255 </tr>
 256 <tr>
 257 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 258 <td>the name of the property</td>
 259 </tr>
 260 <tr>
 261 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 262 <td>the <span class="type">GParamSpec</span> for the property
 263 or <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if no property was found. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 264 </td>
 265 </tr>
 266 </tbody>
 267 </table></div>
 268 <p class="since">Since 0.14</p>
 269 </div>
 270 <hr>
 271 <div class="refsect2">
 272 <a name="json-serializable-get-property"></a><h3>json_serializable_get_property ()</h3>
 273 <pre class="programlisting"><span class="returnvalue">void</span>                json_serializable_get_property      (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
 274                                                          <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>,
 275                                                          <em class="parameter"><code><span class="type">GValue</span> *value</code></em>);</pre>
 276 </div>
 277 <hr>
 278 <div class="refsect2">
 279 <a name="json-serializable-list-properties"></a><h3>json_serializable_list_properties ()</h3>
 280 <pre class="programlisting"><span class="returnvalue">GParamSpec</span> **       json_serializable_list_properties   (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
 281                                                          <em class="parameter"><code><span class="type">guint</span> *n_pspecs</code></em>);</pre>
 282 <p>
 283 FIXME
 284 </p>
 285 <div class="variablelist"><table border="0">
 286 <col align="left" valign="top">
 287 <tbody>
 288 <tr>
 289 <td><p><span class="term"><em class="parameter"><code>serializable</code></em> :</span></p></td>
 290 <td>a <span class="type">JsonSerializable</span>
 291 </td>
 292 </tr>
 293 <tr>
 294 <td><p><span class="term"><em class="parameter"><code>n_pspecs</code></em> :</span></p></td>
 295 <td>return location for the length of the array
 296 of <span class="type">GParamSpec</span> returned by the function. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 297 </td>
 298 </tr>
 299 <tr>
 300 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 301 <td>an array
 302 of <span class="type">GParamSpec</span>. Use <code class="function">g_free()</code> to free the array when done. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_pspecs][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
 303 </td>
 304 </tr>
 305 </tbody>
 306 </table></div>
 307 <p class="since">Since 0.14</p>
 308 </div>
 309 <hr>
 310 <div class="refsect2">
 311 <a name="json-serializable-set-property"></a><h3>json_serializable_set_property ()</h3>
 312 <pre class="programlisting"><span class="returnvalue">void</span>                json_serializable_set_property      (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
 313                                                          <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>,
 314                                                          <em class="parameter"><code>const <span class="type">GValue</span> *value</code></em>);</pre>
 315 </div>
 316 <hr>
 317 <div class="refsect2">
 318 <a name="json-serializable-default-serialize-property"></a><h3>json_serializable_default_serialize_property ()</h3>
 319 <pre class="programlisting"><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="returnvalue">JsonNode</span></a> *          json_serializable_default_serialize_property
 320                                                         (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
 321                                                          <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
 322                                                          <em class="parameter"><code>const <span class="type">GValue</span> *value</code></em>,
 323                                                          <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>);</pre>
 324 <p>
 325 Calls the default implementation of the <span class="type">JsonSerializable</span>
 326 <code class="function">serialize_property()</code> virtual function
 327 </p>
 328 <p>
 329 This function can be used inside a custom implementation
 330 of the <code class="function">serialize_property()</code> virtual function in lieu of:
 331 </p>
 332 <p>
 333 </p>
 334 <div class="informalexample">
 335   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 336     <tbody>
 337       <tr>
 338         <td class="listing_lines" align="right"><pre>1
 339 2
 340 3
 341 4
 342 5
 343 6
 344 7</pre></td>
 345         <td class="listing_code"><pre class="programlisting"><span class="usertype">JsonSerializable</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">iface</span><span class="symbol">;</span>
 346 <span class="usertype">JsonNode</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">node</span><span class="symbol">;</span>
 347
 348 <span class="normal">iface </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_type_default_interface_peek</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">JSON_TYPE_SERIALIZABLE</span><span class="symbol">);</span>
 349 <span class="normal">node </span><span class="symbol">=</span><span class="normal"> iface</span><span class="symbol">-&gt;</span><span class="function">serialize_property</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">serializable</span><span class="symbol">,</span><span class="normal"> property_name</span><span class="symbol">,</span>
 350 <span class="normal">                                  value</span><span class="symbol">,</span>
 351 <span class="normal">                                  pspec</span><span class="symbol">);</span></pre></td>
 352       </tr>
 353     </tbody>
 354   </table>
 355 </div>
 356
 357 <p>
 358 </p>
 359 <div class="variablelist"><table border="0">
 360 <col align="left" valign="top">
 361 <tbody>
 362 <tr>
 363 <td><p><span class="term"><em class="parameter"><code>serializable</code></em> :</span></p></td>
 364 <td>a <span class="type">JsonSerializable</span> object</td>
 365 </tr>
 366 <tr>
 367 <td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
 368 <td>the name of the property</td>
 369 </tr>
 370 <tr>
 371 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 372 <td>the value of the property</td>
 373 </tr>
 374 <tr>
 375 <td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>
 376 <td>a <span class="type">GParamSpec</span>
 377 </td>
 378 </tr>
 379 <tr>
 380 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 381 <td>a <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> containing the serialized
 382 property. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 383 </td>
 384 </tr>
 385 </tbody>
 386 </table></div>
 387 <p class="since">Since 0.10</p>
 388 </div>
 389 <hr>
 390 <div class="refsect2">
 391 <a name="json-serializable-default-deserialize-property"></a><h3>json_serializable_default_deserialize_property ()</h3>
 392 <pre class="programlisting"><span class="returnvalue">gboolean</span>            json_serializable_default_deserialize_property
 393                                                         (<em class="parameter"><code><span class="type">JsonSerializable</span> *serializable</code></em>,
 394                                                          <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
 395                                                          <em class="parameter"><code><span class="type">GValue</span> *value</code></em>,
 396                                                          <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>,
 397                                                          <em class="parameter"><code><a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> *property_node</code></em>);</pre>
 398 <p>
 399 Calls the default implementation of the <span class="type">JsonSerializable</span>
 400 <code class="function">deserialize_property()</code> virtual function
 401 </p>
 402 <p>
 403 This function can be used inside a custom implementation
 404 of the <code class="function">deserialize_property()</code> virtual function in lieu of:
 405 </p>
 406 <p>
 407 </p>
 408 <div class="informalexample">
 409   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 410     <tbody>
 411       <tr>
 412         <td class="listing_lines" align="right"><pre>1
 413 2
 414 3
 415 4
 416 5
 417 6
 418 7
 419 8</pre></td>
 420         <td class="listing_code"><pre class="programlisting"><span class="usertype">JsonSerializable</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">iface</span><span class="symbol">;</span>
 421 <span class="usertype">gboolean</span><span class="normal"> res</span><span class="symbol">;</span>
 422
 423 <span class="normal">iface </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_type_default_interface_peek</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">JSON_TYPE_SERIALIZABLE</span><span class="symbol">);</span>
 424 <span class="normal">res </span><span class="symbol">=</span><span class="normal"> iface</span><span class="symbol">-&gt;</span><span class="function">deserialize_property</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">serializable</span><span class="symbol">,</span><span class="normal"> property_name</span><span class="symbol">,</span>
 425 <span class="normal">                                   value</span><span class="symbol">,</span>
 426 <span class="normal">                                   pspec</span><span class="symbol">,</span>
 427 <span class="normal">                                   property_node</span><span class="symbol">);</span></pre></td>
 428       </tr>
 429     </tbody>
 430   </table>
 431 </div>
 432
 433 <p>
 434 </p>
 435 <div class="variablelist"><table border="0">
 436 <col align="left" valign="top">
 437 <tbody>
 438 <tr>
 439 <td><p><span class="term"><em class="parameter"><code>serializable</code></em> :</span></p></td>
 440 <td>a <span class="type">JsonSerializable</span>
 441 </td>
 442 </tr>
 443 <tr>
 444 <td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
 445 <td>the name of the property</td>
 446 </tr>
 447 <tr>
 448 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 449 <td>a pointer to an uninitialized <span class="type">GValue</span>
 450 </td>
 451 </tr>
 452 <tr>
 453 <td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>
 454 <td>a <span class="type">GParamSpec</span>
 455 </td>
 456 </tr>
 457 <tr>
 458 <td><p><span class="term"><em class="parameter"><code>property_node</code></em> :</span></p></td>
 459 <td>a <a class="link" href="json-glib-JSON-Node.html#JsonNode" title="JsonNode"><span class="type">JsonNode</span></a> containing the serialized property</td>
 460 </tr>
 461 <tr>
 462 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 463 <td>
 464 <code class="literal">TRUE</code> if the property was successfully deserialized.</td>
 465 </tr>
 466 </tbody>
 467 </table></div>
 468 <p class="since">Since 0.10</p>
 469 </div>
 470 </div>
 471 </div>
 472 <div class="footer">
 473 <hr>
 474           Generated by GTK-Doc V1.18.1</div>
 475 </body>
 476 </html>