XML Category Functions

XML Category Functions — Functions to parse glabels XML category definition files

Synopsis


#include <libglabels/xml-category.h>


GList*      lgl_xml_category_read_categories_from_file
                                            (gchar *utf8_filename);
GList*      lgl_xml_category_parse_categories_doc
                                            (xmlDocPtr categories_doc);
lglCategory* lgl_xml_category_parse_category_node
                                            (xmlNodePtr category_node);

Description

This section describes a number of functions for parsing glabels XML category definition files.

Details

lgl_xml_category_read_categories_from_file ()

GList*      lgl_xml_category_read_categories_from_file
                                            (gchar *utf8_filename);

Read category definitions from a file.

utf8_filename : Filename of categories file (name encoded as UTF-8)
Returns : a list of lglCategory structures.

lgl_xml_category_parse_categories_doc ()

GList*      lgl_xml_category_parse_categories_doc
                                            (xmlDocPtr categories_doc);

Read category definitions from a libxml xmlDocPtr tree.

categories_doc : libxml xmlDocPtr tree, representing a categories definition file.
Returns : a list of lglCategory structures.

lgl_xml_category_parse_category_node ()

lglCategory* lgl_xml_category_parse_category_node
                                            (xmlNodePtr category_node);

Read a single category definition from a libxml xmlNodePtr node.

category_node : libxml xmlNodePtr category node from a xmlDocPtr tree.
Returns : a pointer to a newly created lglCategory structure.