rt-thread/components/rtgui/include/rtgui/rtgui_xml.h

#ifndef __RTGUI_XML_H__
#define __RTGUI_XML_H__

#include <rtgui/rtgui.h>

/* Types of events: start element, end element, text, attr name, attr
   val and start/end document. Other events can be ignored! */
enum
{
    EVENT_START = 0, /* Start tag */
    EVENT_END,       /* End tag */
    EVENT_TEXT,      /* Text */
    EVENT_NAME,      /* Attribute name */
    EVENT_VAL,       /* Attribute value */
    EVENT_END_DOC,   /* End of document */
    EVENT_COPY,      /* Internal only; copies to internal buffer */
    EVENT_NONE       /* Internal only; should never see this event */
};

/* xml structure typedef */
typedef struct rtgui_xml rtgui_xml_t;
typedef int (*rtgui_xml_event_handler_t)(rt_uint8_t event, const char *text, rt_size_t len, void *user);

/* create a xml parser context */
rtgui_xml_t *rtgui_xml_create(rt_size_t buffer_size, rtgui_xml_event_handler_t handler, void *user);
/* destroy a xml parser context */
void rtgui_xml_destroy(rtgui_xml_t *rtgui_xml);

/* parse xml buffer */
int rtgui_xml_parse(rtgui_xml_t *rtgui_xml, const char *buf, rt_size_t len);

/* event string */
const char *rtgui_xml_event_str(rt_uint8_t event);

#endif