GNOME.org

XML Template Functions

XML Template Functions — Functions to create and parse glabels XML template nodes and files

Synopsis


#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);

Description

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.

Details

lgl_xml_template_read_templates_from_file ()

GList *             lgl_xml_template_read_templates_from_file
                                                        (const gchar *utf8_filename);

Read glabels templates from template file.

utf8_filename :

 Filename of papers file (name encoded as UTF-8)

Returns :

 a list of lglTemplate structures.

lgl_xml_template_parse_templates_doc ()

GList *             lgl_xml_template_parse_templates_doc
                                                        (const xmlDocPtr templates_doc);

Read glabels templates from a libxml xmlDocPtr tree.

templates_doc :

 libxml xmlDocPtr tree, representing template file.

Returns :

 a list of lglTemplate structures.

lgl_xml_template_parse_template_node ()

lglTemplate *       lgl_xml_template_parse_template_node
                                                        (const xmlNodePtr template_node);

Read a single glabels template from a libxml xmlNodePtr node.

template_node :

 libxml xmlNodePtr template node from a xmlDocPtr tree.

Returns :

 a pointer to a newly created lglTemplate structure.

lgl_xml_template_write_templates_to_file ()

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.

templates :

 List of lglTemplate structures

utf8_filename :

 Filename of templates file (name encoded as UTF-8)

Returns :

 the number of bytes written or -1 in case of failure

lgl_xml_template_write_template_to_file ()

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.

template :

 lglTemplate structure to be written

utf8_filename :

 Filename of templates file (name encoded as UTF-8)

Returns :

 the number of bytes written or -1 in case of failure

lgl_xml_template_create_template_node ()

void                lgl_xml_template_create_template_node
                                                        (const lglTemplate *template,
                                                         xmlNodePtr root,
                                                         const xmlNsPtr ns);

Add a single lglTemplate child node to given xmlNodePtr.

template :

 lglTemplate structure to be written

root :

 parent node to receive new child node

ns :

 a libxml xmlNsPtr