## XML Category Functions

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

## Functions

GList * | lgl_xml_category_read_categories_from_file ()
GList * | lgl_xml_category_parse_categories_doc ()
lglCategory * | lgl_xml_category_parse_category_node ()

## Includes

    #include <libglabels/lgl-xml-category.h>

## Description

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

## Functions

### lgl_xml_category_read_categories_from_file ()

    GList *
    lgl_xml_category_read_categories_from_file
                                   (gchar *utf8_filename);

Read category definitions from a file.

#### Parameters

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.

#### Parameters

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.

#### Parameters

category_node | libxml xmlNodePtr category node from a xmlDocPtr tree. |

#### Returns

a pointer to a newly created lglCategory structure.

## Types and Values