git.sur5r.net Git - glabels/blob - docs/libglabels/html/libglabels-xml.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>XML Helper Functions</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
   7 <link rel="home" href="index.html" title="LibGlabels Reference Manual">
   8 <link rel="up" href="ch02.html" title="Working Directly With LibGlabels XML">
   9 <link rel="prev" href="libglabels-xml-template.html" title="XML Template Functions">
  10 <link rel="next" href="ch03.html" title="Miscellaneous">
  11 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 <link rel="chapter" href="ch01.html" title="Basic LibGlabels Usage">
  14 <link rel="chapter" href="ch02.html" title="Working Directly With LibGlabels XML">
  15 <link rel="chapter" href="ch03.html" title="Miscellaneous">
  16 </head>
  17 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  18 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  19 <tr valign="middle">
  20 <td><a accesskey="p" href="libglabels-xml-template.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  21 <td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  22 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  23 <th width="100%" align="center">LibGlabels Reference Manual</th>
  24 <td><a accesskey="n" href="ch03.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  25 </tr>
  26 <tr><td colspan="5" class="shortcuts">
  27 <a href="#libglabels-xml.synopsis" class="shortcut">Top</a>
  28                  |
  29                 <a href="#libglabels-xml.description" class="shortcut">Description</a>
  30 </td></tr>
  31 </table>
  32 <div class="refentry" title="XML Helper Functions">
  33 <a name="libglabels-xml"></a><div class="titlepage"></div>
  34 <div class="refnamediv"><table width="100%"><tr>
  35 <td valign="top">
  36 <h2><span class="refentrytitle"><a name="libglabels-xml.top_of_page"></a>XML Helper Functions</span></h2>
  37 <p>XML Helper Functions — Functions to help format and parse glabels XML properties</p>
  38 </td>
  39 <td valign="top" align="right"></td>
  40 </tr></table></div>
  41 <div class="refsynopsisdiv" title="Synopsis">
  42 <a name="libglabels-xml.synopsis"></a><h2>Synopsis</h2>
  43 <pre class="synopsis">
  44
  45 #include &lt;libglabels/xml.h&gt;
  46
  47 #define             <a class="link" href="libglabels-xml.html#LGL-XML-NAME-SPACE--CAPS" title="LGL_XML_NAME_SPACE">LGL_XML_NAME_SPACE</a>
  48
  49 <a
  50 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  51 >gchar</a> *             <a class="link" href="libglabels-xml.html#lgl-xml-get-prop-string" title="lgl_xml_get_prop_string ()">lgl_xml_get_prop_string</a>             (xmlNodePtr node,
  52                                                          const <a
  53 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  54 >gchar</a> *property,
  55                                                          const <a
  56 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  57 >gchar</a> *default_val);
  58 <a
  59 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  60 >gchar</a> *             <a class="link" href="libglabels-xml.html#lgl-xml-get-prop-i18n-string" title="lgl_xml_get_prop_i18n_string ()">lgl_xml_get_prop_i18n_string</a>        (xmlNodePtr node,
  61                                                          const <a
  62 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  63 >gchar</a> *property,
  64                                                          const <a
  65 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  66 >gchar</a> *default_val);
  67 <a
  68 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
  69 >gdouble</a>             <a class="link" href="libglabels-xml.html#lgl-xml-get-prop-double" title="lgl_xml_get_prop_double ()">lgl_xml_get_prop_double</a>             (xmlNodePtr node,
  70                                                          const <a
  71 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  72 >gchar</a> *property,
  73                                                          <a
  74 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
  75 >gdouble</a> default_val);
  76 <a
  77 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
  78 >gboolean</a>            <a class="link" href="libglabels-xml.html#lgl-xml-get-prop-boolean" title="lgl_xml_get_prop_boolean ()">lgl_xml_get_prop_boolean</a>            (xmlNodePtr node,
  79                                                          const <a
  80 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  81 >gchar</a> *property,
  82                                                          <a
  83 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
  84 >gboolean</a> default_val);
  85 <a
  86 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
  87 >gint</a>                <a class="link" href="libglabels-xml.html#lgl-xml-get-prop-int" title="lgl_xml_get_prop_int ()">lgl_xml_get_prop_int</a>                (xmlNodePtr node,
  88                                                          const <a
  89 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  90 >gchar</a> *property,
  91                                                          <a
  92 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
  93 >gint</a> default_val);
  94 <a
  95 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
  96 >guint</a>               <a class="link" href="libglabels-xml.html#lgl-xml-get-prop-uint" title="lgl_xml_get_prop_uint ()">lgl_xml_get_prop_uint</a>               (xmlNodePtr node,
  97                                                          const <a
  98 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  99 >gchar</a> *property,
 100                                                          <a
 101 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
 102 >guint</a> default_val);
 103 <a
 104 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
 105 >gdouble</a>             <a class="link" href="libglabels-xml.html#lgl-xml-get-prop-length" title="lgl_xml_get_prop_length ()">lgl_xml_get_prop_length</a>             (xmlNodePtr node,
 106                                                          const <a
 107 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 108 >gchar</a> *property,
 109                                                          <a
 110 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
 111 >gdouble</a> default_val);
 112
 113 void                <a class="link" href="libglabels-xml.html#lgl-xml-set-prop-string" title="lgl_xml_set_prop_string ()">lgl_xml_set_prop_string</a>             (xmlNodePtr node,
 114                                                          const <a
 115 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 116 >gchar</a> *property,
 117                                                          const <a
 118 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 119 >gchar</a> *val);
 120 void                <a class="link" href="libglabels-xml.html#lgl-xml-set-prop-double" title="lgl_xml_set_prop_double ()">lgl_xml_set_prop_double</a>             (xmlNodePtr node,
 121                                                          const <a
 122 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 123 >gchar</a> *property,
 124                                                          <a
 125 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
 126 >gdouble</a> val);
 127 void                <a class="link" href="libglabels-xml.html#lgl-xml-set-prop-boolean" title="lgl_xml_set_prop_boolean ()">lgl_xml_set_prop_boolean</a>            (xmlNodePtr node,
 128                                                          const <a
 129 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 130 >gchar</a> *property,
 131                                                          <a
 132 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 133 >gboolean</a> val);
 134 void                <a class="link" href="libglabels-xml.html#lgl-xml-set-prop-int" title="lgl_xml_set_prop_int ()">lgl_xml_set_prop_int</a>                (xmlNodePtr node,
 135                                                          const <a
 136 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 137 >gchar</a> *property,
 138                                                          <a
 139 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 140 >gint</a> val);
 141 void                <a class="link" href="libglabels-xml.html#lgl-xml-set-prop-uint-hex" title="lgl_xml_set_prop_uint_hex ()">lgl_xml_set_prop_uint_hex</a>           (xmlNodePtr node,
 142                                                          const <a
 143 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 144 >gchar</a> *property,
 145                                                          <a
 146 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
 147 >guint</a> val);
 148 void                <a class="link" href="libglabels-xml.html#lgl-xml-set-prop-length" title="lgl_xml_set_prop_length ()">lgl_xml_set_prop_length</a>             (xmlNodePtr node,
 149                                                          const <a
 150 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 151 >gchar</a> *property,
 152                                                          <a
 153 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
 154 >gdouble</a> val);
 155
 156 <a
 157 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 158 >gboolean</a>            <a class="link" href="libglabels-xml.html#lgl-xml-is-node" title="lgl_xml_is_node ()">lgl_xml_is_node</a>                     (xmlNodePtr node,
 159                                                          const <a
 160 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 161 >gchar</a> *name);
 162 <a
 163 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 164 >gchar</a> *             <a class="link" href="libglabels-xml.html#lgl-xml-get-node-content" title="lgl_xml_get_node_content ()">lgl_xml_get_node_content</a>            (xmlNodePtr node);
 165
 166 void                <a class="link" href="libglabels-xml.html#lgl-xml-set-default-units" title="lgl_xml_set_default_units ()">lgl_xml_set_default_units</a>           (<a class="link" href="libglabels-enums.html#lglUnitsType" title="enum lglUnitsType">lglUnitsType</a> units);
 167 </pre>
 168 </div>
 169 <div class="refsect1" title="Description">
 170 <a name="libglabels-xml.description"></a><h2>Description</h2>
 171 <p>
 172 This section describes a number of "helper" functions for formatting and
 173 parsing various types of properties for tags in glabels XML file formats.
 174 </p>
 175 <p>
 176 These functions are basically wrappers to functions from libxml2.
 177 </p>
 178 </div>
 179 <div class="refsect1" title="Details">
 180 <a name="libglabels-xml.details"></a><h2>Details</h2>
 181 <div class="refsect2" title="LGL_XML_NAME_SPACE">
 182 <a name="LGL-XML-NAME-SPACE--CAPS"></a><h3>LGL_XML_NAME_SPACE</h3>
 183 <pre class="programlisting">#define LGL_XML_NAME_SPACE "http://snaught.com/glabels/2.2/"
 184 </pre>
 185 <p>
 186 </p>
 187 </div>
 188 <hr>
 189 <div class="refsect2" title="lgl_xml_get_prop_string ()">
 190 <a name="lgl-xml-get-prop-string"></a><h3>lgl_xml_get_prop_string ()</h3>
 191 <pre class="programlisting"><a
 192 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 193 >gchar</a> *             lgl_xml_get_prop_string             (xmlNodePtr node,
 194                                                          const <a
 195 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 196 >gchar</a> *property,
 197                                                          const <a
 198 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 199 >gchar</a> *default_val);</pre>
 200 <p>
 201 Return value of property as a string.</p>
 202 <p>
 203 </p>
 204 <div class="variablelist"><table border="0">
 205 <col align="left" valign="top">
 206 <tbody>
 207 <tr>
 208 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 209 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 210 </td>
 211 </tr>
 212 <tr>
 213 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 214 <td>    the property name
 215 </td>
 216 </tr>
 217 <tr>
 218 <td><p><span class="term"><em class="parameter"><code>default_val</code></em> :</span></p></td>
 219 <td> a default value to return if property not found
 220 </td>
 221 </tr>
 222 <tr>
 223 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 224 <td> the property as a pointer to a gchar string.  This string should
 225          be freed with <a
 226 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
 227 ><code class="function">g_free()</code></a>.
 228
 229 </td>
 230 </tr>
 231 </tbody>
 232 </table></div>
 233 </div>
 234 <hr>
 235 <div class="refsect2" title="lgl_xml_get_prop_i18n_string ()">
 236 <a name="lgl-xml-get-prop-i18n-string"></a><h3>lgl_xml_get_prop_i18n_string ()</h3>
 237 <pre class="programlisting"><a
 238 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 239 >gchar</a> *             lgl_xml_get_prop_i18n_string        (xmlNodePtr node,
 240                                                          const <a
 241 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 242 >gchar</a> *property,
 243                                                          const <a
 244 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 245 >gchar</a> *default_val);</pre>
 246 <p>
 247 Return value of a translatable property as a string.</p>
 248 <p>
 249 </p>
 250 <div class="variablelist"><table border="0">
 251 <col align="left" valign="top">
 252 <tbody>
 253 <tr>
 254 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 255 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 256 </td>
 257 </tr>
 258 <tr>
 259 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 260 <td>    the property name
 261 </td>
 262 </tr>
 263 <tr>
 264 <td><p><span class="term"><em class="parameter"><code>default_val</code></em> :</span></p></td>
 265 <td> a default value to return if property not found
 266 </td>
 267 </tr>
 268 <tr>
 269 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 270 <td> the property as a pointer to a gchar string.  This string should
 271          be freed with <a
 272 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
 273 ><code class="function">g_free()</code></a>.
 274
 275 </td>
 276 </tr>
 277 </tbody>
 278 </table></div>
 279 </div>
 280 <hr>
 281 <div class="refsect2" title="lgl_xml_get_prop_double ()">
 282 <a name="lgl-xml-get-prop-double"></a><h3>lgl_xml_get_prop_double ()</h3>
 283 <pre class="programlisting"><a
 284 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
 285 >gdouble</a>             lgl_xml_get_prop_double             (xmlNodePtr node,
 286                                                          const <a
 287 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 288 >gchar</a> *property,
 289                                                          <a
 290 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
 291 >gdouble</a> default_val);</pre>
 292 <p>
 293 Return value of property as a double.</p>
 294 <p>
 295 </p>
 296 <div class="variablelist"><table border="0">
 297 <col align="left" valign="top">
 298 <tbody>
 299 <tr>
 300 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 301 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 302 </td>
 303 </tr>
 304 <tr>
 305 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 306 <td>    the property name
 307 </td>
 308 </tr>
 309 <tr>
 310 <td><p><span class="term"><em class="parameter"><code>default_val</code></em> :</span></p></td>
 311 <td> a default value to return if property not found
 312 </td>
 313 </tr>
 314 <tr>
 315 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 316 <td> the property as a double.
 317
 318 </td>
 319 </tr>
 320 </tbody>
 321 </table></div>
 322 </div>
 323 <hr>
 324 <div class="refsect2" title="lgl_xml_get_prop_boolean ()">
 325 <a name="lgl-xml-get-prop-boolean"></a><h3>lgl_xml_get_prop_boolean ()</h3>
 326 <pre class="programlisting"><a
 327 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 328 >gboolean</a>            lgl_xml_get_prop_boolean            (xmlNodePtr node,
 329                                                          const <a
 330 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 331 >gchar</a> *property,
 332                                                          <a
 333 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 334 >gboolean</a> default_val);</pre>
 335 <p>
 336 Return value of property as a boolean.</p>
 337 <p>
 338 </p>
 339 <div class="variablelist"><table border="0">
 340 <col align="left" valign="top">
 341 <tbody>
 342 <tr>
 343 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 344 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 345 </td>
 346 </tr>
 347 <tr>
 348 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 349 <td>    the property name
 350 </td>
 351 </tr>
 352 <tr>
 353 <td><p><span class="term"><em class="parameter"><code>default_val</code></em> :</span></p></td>
 354 <td> a default value to return if property not found
 355 </td>
 356 </tr>
 357 <tr>
 358 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 359 <td> the property as a boolean.
 360
 361 </td>
 362 </tr>
 363 </tbody>
 364 </table></div>
 365 </div>
 366 <hr>
 367 <div class="refsect2" title="lgl_xml_get_prop_int ()">
 368 <a name="lgl-xml-get-prop-int"></a><h3>lgl_xml_get_prop_int ()</h3>
 369 <pre class="programlisting"><a
 370 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 371 >gint</a>                lgl_xml_get_prop_int                (xmlNodePtr node,
 372                                                          const <a
 373 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 374 >gchar</a> *property,
 375                                                          <a
 376 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 377 >gint</a> default_val);</pre>
 378 <p>
 379 Return value of property as an integer.</p>
 380 <p>
 381 </p>
 382 <div class="variablelist"><table border="0">
 383 <col align="left" valign="top">
 384 <tbody>
 385 <tr>
 386 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 387 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 388 </td>
 389 </tr>
 390 <tr>
 391 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 392 <td>    the property name
 393 </td>
 394 </tr>
 395 <tr>
 396 <td><p><span class="term"><em class="parameter"><code>default_val</code></em> :</span></p></td>
 397 <td> a default value to return if property not found
 398 </td>
 399 </tr>
 400 <tr>
 401 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 402 <td> the property as an integer.
 403
 404 </td>
 405 </tr>
 406 </tbody>
 407 </table></div>
 408 </div>
 409 <hr>
 410 <div class="refsect2" title="lgl_xml_get_prop_uint ()">
 411 <a name="lgl-xml-get-prop-uint"></a><h3>lgl_xml_get_prop_uint ()</h3>
 412 <pre class="programlisting"><a
 413 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
 414 >guint</a>               lgl_xml_get_prop_uint               (xmlNodePtr node,
 415                                                          const <a
 416 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 417 >gchar</a> *property,
 418                                                          <a
 419 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
 420 >guint</a> default_val);</pre>
 421 <p>
 422 Return value of property (usually formatted in hex) as an unsigned integer.</p>
 423 <p>
 424 </p>
 425 <div class="variablelist"><table border="0">
 426 <col align="left" valign="top">
 427 <tbody>
 428 <tr>
 429 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 430 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 431 </td>
 432 </tr>
 433 <tr>
 434 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 435 <td>    the property name
 436 </td>
 437 </tr>
 438 <tr>
 439 <td><p><span class="term"><em class="parameter"><code>default_val</code></em> :</span></p></td>
 440 <td> a default value to return if property not found
 441 </td>
 442 </tr>
 443 <tr>
 444 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 445 <td> the property as an unsigned integer.
 446
 447 </td>
 448 </tr>
 449 </tbody>
 450 </table></div>
 451 </div>
 452 <hr>
 453 <div class="refsect2" title="lgl_xml_get_prop_length ()">
 454 <a name="lgl-xml-get-prop-length"></a><h3>lgl_xml_get_prop_length ()</h3>
 455 <pre class="programlisting"><a
 456 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
 457 >gdouble</a>             lgl_xml_get_prop_length             (xmlNodePtr node,
 458                                                          const <a
 459 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 460 >gchar</a> *property,
 461                                                          <a
 462 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
 463 >gdouble</a> default_val);</pre>
 464 <p>
 465 Return value of a length property as a double, converting to internal
 466 units (points).  The property is expected to be formatted as a number
 467 followed by a units string.  If there is no units string, the length
 468 is assumed to be in points.  Valid units strings are "pt" for points,
 469 "in" for inches, "mm" for millimeters, "cm" for centimeters, and
 470 "pc" for picas.</p>
 471 <p>
 472 </p>
 473 <div class="variablelist"><table border="0">
 474 <col align="left" valign="top">
 475 <tbody>
 476 <tr>
 477 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 478 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 479 </td>
 480 </tr>
 481 <tr>
 482 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 483 <td>    the property name
 484 </td>
 485 </tr>
 486 <tr>
 487 <td><p><span class="term"><em class="parameter"><code>default_val</code></em> :</span></p></td>
 488 <td> a default value to return if property not found
 489 </td>
 490 </tr>
 491 <tr>
 492 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 493 <td> the length in points.
 494
 495 </td>
 496 </tr>
 497 </tbody>
 498 </table></div>
 499 </div>
 500 <hr>
 501 <div class="refsect2" title="lgl_xml_set_prop_string ()">
 502 <a name="lgl-xml-set-prop-string"></a><h3>lgl_xml_set_prop_string ()</h3>
 503 <pre class="programlisting">void                lgl_xml_set_prop_string             (xmlNodePtr node,
 504                                                          const <a
 505 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 506 >gchar</a> *property,
 507                                                          const <a
 508 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 509 >gchar</a> *val);</pre>
 510 <p>
 511 Set a property from a string.</p>
 512 <p>
 513 </p>
 514 <div class="variablelist"><table border="0">
 515 <col align="left" valign="top">
 516 <tbody>
 517 <tr>
 518 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 519 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 520 </td>
 521 </tr>
 522 <tr>
 523 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 524 <td>    the property name
 525 </td>
 526 </tr>
 527 <tr>
 528 <td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
 529 <td>         the value to set
 530 </td>
 531 </tr>
 532 </tbody>
 533 </table></div>
 534 </div>
 535 <hr>
 536 <div class="refsect2" title="lgl_xml_set_prop_double ()">
 537 <a name="lgl-xml-set-prop-double"></a><h3>lgl_xml_set_prop_double ()</h3>
 538 <pre class="programlisting">void                lgl_xml_set_prop_double             (xmlNodePtr node,
 539                                                          const <a
 540 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 541 >gchar</a> *property,
 542                                                          <a
 543 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
 544 >gdouble</a> val);</pre>
 545 <p>
 546 Set a property from a double.</p>
 547 <p>
 548 </p>
 549 <div class="variablelist"><table border="0">
 550 <col align="left" valign="top">
 551 <tbody>
 552 <tr>
 553 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 554 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 555 </td>
 556 </tr>
 557 <tr>
 558 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 559 <td>    the property name
 560 </td>
 561 </tr>
 562 <tr>
 563 <td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
 564 <td>         the value to set
 565 </td>
 566 </tr>
 567 </tbody>
 568 </table></div>
 569 </div>
 570 <hr>
 571 <div class="refsect2" title="lgl_xml_set_prop_boolean ()">
 572 <a name="lgl-xml-set-prop-boolean"></a><h3>lgl_xml_set_prop_boolean ()</h3>
 573 <pre class="programlisting">void                lgl_xml_set_prop_boolean            (xmlNodePtr node,
 574                                                          const <a
 575 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 576 >gchar</a> *property,
 577                                                          <a
 578 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 579 >gboolean</a> val);</pre>
 580 <p>
 581 Set a property from a boolean.</p>
 582 <p>
 583 </p>
 584 <div class="variablelist"><table border="0">
 585 <col align="left" valign="top">
 586 <tbody>
 587 <tr>
 588 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 589 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 590 </td>
 591 </tr>
 592 <tr>
 593 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 594 <td>    the property name
 595 </td>
 596 </tr>
 597 <tr>
 598 <td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
 599 <td>         the value to set
 600 </td>
 601 </tr>
 602 </tbody>
 603 </table></div>
 604 </div>
 605 <hr>
 606 <div class="refsect2" title="lgl_xml_set_prop_int ()">
 607 <a name="lgl-xml-set-prop-int"></a><h3>lgl_xml_set_prop_int ()</h3>
 608 <pre class="programlisting">void                lgl_xml_set_prop_int                (xmlNodePtr node,
 609                                                          const <a
 610 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 611 >gchar</a> *property,
 612                                                          <a
 613 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
 614 >gint</a> val);</pre>
 615 <p>
 616 Set a property from an integer.</p>
 617 <p>
 618 </p>
 619 <div class="variablelist"><table border="0">
 620 <col align="left" valign="top">
 621 <tbody>
 622 <tr>
 623 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 624 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 625 </td>
 626 </tr>
 627 <tr>
 628 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 629 <td>    the property name
 630 </td>
 631 </tr>
 632 <tr>
 633 <td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
 634 <td>         the value to set
 635 </td>
 636 </tr>
 637 </tbody>
 638 </table></div>
 639 </div>
 640 <hr>
 641 <div class="refsect2" title="lgl_xml_set_prop_uint_hex ()">
 642 <a name="lgl-xml-set-prop-uint-hex"></a><h3>lgl_xml_set_prop_uint_hex ()</h3>
 643 <pre class="programlisting">void                lgl_xml_set_prop_uint_hex           (xmlNodePtr node,
 644                                                          const <a
 645 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 646 >gchar</a> *property,
 647                                                          <a
 648 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
 649 >guint</a> val);</pre>
 650 <p>
 651 Set a property from an unsigned integer and format in hex.</p>
 652 <p>
 653 </p>
 654 <div class="variablelist"><table border="0">
 655 <col align="left" valign="top">
 656 <tbody>
 657 <tr>
 658 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 659 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 660 </td>
 661 </tr>
 662 <tr>
 663 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 664 <td>    the property name
 665 </td>
 666 </tr>
 667 <tr>
 668 <td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
 669 <td>         the value to set
 670 </td>
 671 </tr>
 672 </tbody>
 673 </table></div>
 674 </div>
 675 <hr>
 676 <div class="refsect2" title="lgl_xml_set_prop_length ()">
 677 <a name="lgl-xml-set-prop-length"></a><h3>lgl_xml_set_prop_length ()</h3>
 678 <pre class="programlisting">void                lgl_xml_set_prop_length             (xmlNodePtr node,
 679                                                          const <a
 680 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 681 >gchar</a> *property,
 682                                                          <a
 683 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
 684 >gdouble</a> val);</pre>
 685 <p>
 686 Set a property from a length, performing any necessary conversion.
 687 Length properties are formatted as a number followed by a units string.
 688 The units of the formatted property is determined by the most recent call to
 689 <a class="link" href="libglabels-xml.html#lgl-xml-set-default-units" title="lgl_xml_set_default_units ()"><code class="function">lgl_xml_set_default_units()</code></a>.</p>
 690 <p>
 691 </p>
 692 <div class="variablelist"><table border="0">
 693 <col align="left" valign="top">
 694 <tbody>
 695 <tr>
 696 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 697 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 698 </td>
 699 </tr>
 700 <tr>
 701 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
 702 <td>    the property name
 703 </td>
 704 </tr>
 705 <tr>
 706 <td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
 707 <td>         the length to set in internal units (points)
 708 </td>
 709 </tr>
 710 </tbody>
 711 </table></div>
 712 </div>
 713 <hr>
 714 <div class="refsect2" title="lgl_xml_is_node ()">
 715 <a name="lgl-xml-is-node"></a><h3>lgl_xml_is_node ()</h3>
 716 <pre class="programlisting"><a
 717 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 718 >gboolean</a>            lgl_xml_is_node                     (xmlNodePtr node,
 719                                                          const <a
 720 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 721 >gchar</a> *name);</pre>
 722 <p>
 723 Test if a node name matches given name.</p>
 724 <p>
 725 </p>
 726 <div class="variablelist"><table border="0">
 727 <col align="left" valign="top">
 728 <tbody>
 729 <tr>
 730 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 731 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 732 </td>
 733 </tr>
 734 <tr>
 735 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 736 <td>    the node name
 737 </td>
 738 </tr>
 739 <tr>
 740 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 741 <td> TRUE if the name of the node matches.  Otherwise FALSE.
 742
 743 </td>
 744 </tr>
 745 </tbody>
 746 </table></div>
 747 </div>
 748 <hr>
 749 <div class="refsect2" title="lgl_xml_get_node_content ()">
 750 <a name="lgl-xml-get-node-content"></a><h3>lgl_xml_get_node_content ()</h3>
 751 <pre class="programlisting"><a
 752 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
 753 >gchar</a> *             lgl_xml_get_node_content            (xmlNodePtr node);</pre>
 754 <p>
 755 Get the content of a node.</p>
 756 <p>
 757 </p>
 758 <div class="variablelist"><table border="0">
 759 <col align="left" valign="top">
 760 <tbody>
 761 <tr>
 762 <td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
 763 <td>        the libxml2 <span class="type">xmlNodePtr</span> of the node
 764 </td>
 765 </tr>
 766 <tr>
 767 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 768 <td> the property as a pointer to a gchar string.  This string should
 769          be freed with <a
 770 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
 771 ><code class="function">g_free()</code></a>.
 772 </td>
 773 </tr>
 774 </tbody>
 775 </table></div>
 776 </div>
 777 <hr>
 778 <div class="refsect2" title="lgl_xml_set_default_units ()">
 779 <a name="lgl-xml-set-default-units"></a><h3>lgl_xml_set_default_units ()</h3>
 780 <pre class="programlisting">void                lgl_xml_set_default_units           (<a class="link" href="libglabels-enums.html#lglUnitsType" title="enum lglUnitsType">lglUnitsType</a> units);</pre>
 781 <p>
 782 Set the default units when formatting lengths.  See
 783 <a class="link" href="libglabels-xml.html#lgl-xml-set-prop-length" title="lgl_xml_set_prop_length ()"><code class="function">lgl_xml_set_prop_length()</code></a>.</p>
 784 <p>
 785 </p>
 786 <div class="variablelist"><table border="0">
 787 <col align="left" valign="top">
 788 <tbody><tr>
 789 <td><p><span class="term"><em class="parameter"><code>units</code></em> :</span></p></td>
 790 <td>       default units selection (<a class="link" href="libglabels-enums.html#lglUnitsType" title="enum lglUnitsType"><span class="type">lglUnitsType</span></a>)
 791 </td>
 792 </tr></tbody>
 793 </table></div>
 794 </div>
 795 </div>
 796 </div>
 797 <div class="footer">
 798 <hr>
 799           Generated by GTK-Doc V1.11</div>
 800 </body>
 801 </html>