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>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">
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">
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>
26 <tr><td colspan="5" class="shortcuts">
27 <a href="#libglabels-xml.synopsis" class="shortcut">Top</a>
29 <a href="#libglabels-xml.description" class="shortcut">Description</a>
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>
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>
39 <td valign="top" align="right"></td>
41 <div class="refsynopsisdiv" title="Synopsis">
42 <a name="libglabels-xml.synopsis"></a><h2>Synopsis</h2>
43 <pre class="synopsis">
45 #include <libglabels/xml.h>
47 #define <a class="link" href="libglabels-xml.html#LGL-XML-NAME-SPACE--CAPS" title="LGL_XML_NAME_SPACE">LGL_XML_NAME_SPACE</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,
53 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
56 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
57 >gchar</a> *default_val);
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,
62 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
65 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
66 >gchar</a> *default_val);
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,
71 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
74 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
75 >gdouble</a> default_val);
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,
80 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
83 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
84 >gboolean</a> default_val);
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,
89 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
92 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
93 >gint</a> default_val);
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,
98 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
101 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
102 >guint</a> default_val);
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,
107 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
108 >gchar</a> *property,
110 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
111 >gdouble</a> default_val);
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,
115 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
116 >gchar</a> *property,
118 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
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,
122 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
123 >gchar</a> *property,
125 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
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,
129 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
130 >gchar</a> *property,
132 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
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,
136 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
137 >gchar</a> *property,
139 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
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,
143 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
144 >gchar</a> *property,
146 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
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,
150 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
151 >gchar</a> *property,
153 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
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,
160 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
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);
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);
169 <div class="refsect1" title="Description">
170 <a name="libglabels-xml.description"></a><h2>Description</h2>
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.
176 These functions are basically wrappers to functions from libxml2.
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/"
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,
195 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
196 >gchar</a> *property,
198 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
199 >gchar</a> *default_val);</pre>
201 Return value of property as a string.</p>
204 <div class="variablelist"><table border="0">
205 <col align="left" valign="top">
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
213 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
214 <td> the property name
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
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
226 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
227 ><code class="function">g_free()</code></a>.
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,
241 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
242 >gchar</a> *property,
244 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
245 >gchar</a> *default_val);</pre>
247 Return value of a translatable property as a string.</p>
250 <div class="variablelist"><table border="0">
251 <col align="left" valign="top">
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
259 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
260 <td> the property name
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
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
272 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
273 ><code class="function">g_free()</code></a>.
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,
287 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
288 >gchar</a> *property,
290 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
291 >gdouble</a> default_val);</pre>
293 Return value of property as a double.</p>
296 <div class="variablelist"><table border="0">
297 <col align="left" valign="top">
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
305 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
306 <td> the property name
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
315 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
316 <td> the property as a double.
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,
330 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
331 >gchar</a> *property,
333 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
334 >gboolean</a> default_val);</pre>
336 Return value of property as a boolean.</p>
339 <div class="variablelist"><table border="0">
340 <col align="left" valign="top">
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
348 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
349 <td> the property name
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
358 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
359 <td> the property as a boolean.
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,
373 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
374 >gchar</a> *property,
376 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
377 >gint</a> default_val);</pre>
379 Return value of property as an integer.</p>
382 <div class="variablelist"><table border="0">
383 <col align="left" valign="top">
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
391 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
392 <td> the property name
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
401 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
402 <td> the property as an integer.
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,
416 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
417 >gchar</a> *property,
419 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
420 >guint</a> default_val);</pre>
422 Return value of property (usually formatted in hex) as an unsigned integer.</p>
425 <div class="variablelist"><table border="0">
426 <col align="left" valign="top">
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
434 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
435 <td> the property name
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
444 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
445 <td> the property as an unsigned integer.
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,
459 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
460 >gchar</a> *property,
462 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
463 >gdouble</a> default_val);</pre>
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
473 <div class="variablelist"><table border="0">
474 <col align="left" valign="top">
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
482 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
483 <td> the property name
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
492 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
493 <td> the length in points.
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,
505 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
506 >gchar</a> *property,
508 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
509 >gchar</a> *val);</pre>
511 Set a property from a string.</p>
514 <div class="variablelist"><table border="0">
515 <col align="left" valign="top">
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
523 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
524 <td> the property name
528 <td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
529 <td> the value to set
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,
540 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
541 >gchar</a> *property,
543 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
544 >gdouble</a> val);</pre>
546 Set a property from a double.</p>
549 <div class="variablelist"><table border="0">
550 <col align="left" valign="top">
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
558 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
559 <td> the property name
563 <td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
564 <td> the value to set
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,
575 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
576 >gchar</a> *property,
578 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
579 >gboolean</a> val);</pre>
581 Set a property from a boolean.</p>
584 <div class="variablelist"><table border="0">
585 <col align="left" valign="top">
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
593 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
594 <td> the property name
598 <td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
599 <td> the value to set
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,
610 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
611 >gchar</a> *property,
613 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
614 >gint</a> val);</pre>
616 Set a property from an integer.</p>
619 <div class="variablelist"><table border="0">
620 <col align="left" valign="top">
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
628 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
629 <td> the property name
633 <td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
634 <td> the value to set
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,
645 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
646 >gchar</a> *property,
648 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
649 >guint</a> val);</pre>
651 Set a property from an unsigned integer and format in hex.</p>
654 <div class="variablelist"><table border="0">
655 <col align="left" valign="top">
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
663 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
664 <td> the property name
668 <td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
669 <td> the value to set
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,
680 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
681 >gchar</a> *property,
683 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
684 >gdouble</a> val);</pre>
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>
692 <div class="variablelist"><table border="0">
693 <col align="left" valign="top">
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
701 <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
702 <td> the property name
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)
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,
720 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
721 >gchar</a> *name);</pre>
723 Test if a node name matches given name.</p>
726 <div class="variablelist"><table border="0">
727 <col align="left" valign="top">
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
735 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
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.
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>
755 Get the content of a node.</p>
758 <div class="variablelist"><table border="0">
759 <col align="left" valign="top">
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
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
770 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
771 ><code class="function">g_free()</code></a>.
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>
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>
786 <div class="variablelist"><table border="0">
787 <col align="left" valign="top">
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>)
799 Generated by GTK-Doc V1.11</div>