|  |  |  | LibGlabels Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
| XML Template FunctionsXML Template Functions — Functions to create and parse glabels XML template nodes and files | 
#include <libglabels/xml-templates.h> GList * lgl_xml_template_read_templates_from_file (const gchar *utf8_filename); GList * lgl_xml_template_parse_templates_doc (const xmlDocPtr templates_doc); lglTemplate * lgl_xml_template_parse_template_node (const xmlNodePtr template_node); gint lgl_xml_template_write_templates_to_file (GList *templates, const gchar *utf8_filename); gint lgl_xml_template_write_template_to_file (const lglTemplate *template, const gchar *utf8_filename); void lgl_xml_template_create_template_node (const lglTemplate *template, xmlNodePtr root, const xmlNsPtr ns);
This section describes a number of functions for creating and parsing glabels XML template nodes and files. Template nodes are used in both template files and document files.
GList * lgl_xml_template_read_templates_from_file (const gchar *utf8_filename);
Read glabels templates from template file.
| 
 | Filename of papers file (name encoded as UTF-8) | 
| Returns : | a list of lglTemplate structures. | 
GList * lgl_xml_template_parse_templates_doc (const xmlDocPtr templates_doc);
Read glabels templates from a libxml xmlDocPtr tree.
| 
 | libxml xmlDocPtr tree, representing template file. | 
| Returns : | a list of lglTemplate structures. | 
lglTemplate * lgl_xml_template_parse_template_node (const xmlNodePtr template_node);
Read a single glabels template from a libxml xmlNodePtr node.
| 
 | libxml xmlNodePtr template node from a xmlDocPtr tree. | 
| Returns : | a pointer to a newly created lglTemplate structure. | 
gint lgl_xml_template_write_templates_to_file (GList *templates, const gchar *utf8_filename);
Write a list of lglTemplate structures to a glabels XML template file.
| 
 | List of lglTemplate structures | 
| 
 | Filename of templates file (name encoded as UTF-8) | 
| Returns : | the number of bytes written or -1 in case of failure | 
gint lgl_xml_template_write_template_to_file (const lglTemplate *template, const gchar *utf8_filename);
Write a single lglTemplate structures to a glabels XML template file.
| 
 | lglTemplate structure to be written | 
| 
 | Filename of templates file (name encoded as UTF-8) | 
| Returns : | the number of bytes written or -1 in case of failure | 
void                lgl_xml_template_create_template_node
                                                        (const lglTemplate *template,
                                                         xmlNodePtr root,
                                                         const xmlNsPtr ns);
Add a single lglTemplate child node to given xmlNodePtr.
| 
 | lglTemplate structure to be written | 
| 
 | parent node to receive new child node | 
| 
 | a libxml xmlNsPtr |