AWTK API

# XmlBuilder

# 概述

xml builder interface

# 函数

函数名称 说明
xml_builder_destroy 销毁builder对象。
xml_builder_get_attr 获取属性。
xml_builder_on_comment 解析到注释时调用本函数。
xml_builder_on_end 解析到tag结束时调用本函数。
xml_builder_on_error 解析遇到错误时调用本函数。
xml_builder_on_pi 解析到处理指令时调用本函数。
xml_builder_on_start 解析到tag开始时调用本函数。
xml_builder_on_text 解析到文本时调用本函数。

# xml_builder_destroy 函数

  • 函数功能：

销毁builder对象。

  • 函数原型：
void xml_builder_destroy (XmlBuilder* builder);
  • 参数说明：
参数 类型 说明
返回值 void 返回无。
builder XmlBuilder* builder对象。

# xml_builder_get_attr 函数

  • 函数功能：

获取属性。

  • 函数原型：
const char* xml_builder_get_attr (const char** attrs, const char* attr);
  • 参数说明：
参数 类型 说明
返回值 const char* 返回属性的值。
attrs const char** 属性列表。
attr const char* 属性名。

# xml_builder_on_comment 函数

  • 函数功能：

解析到注释时调用本函数。

  • 函数原型：
void xml_builder_on_comment (XmlBuilder* builder, const char* text, size_t length);
  • 参数说明：
参数 类型 说明
返回值 void 返回无。
builder XmlBuilder* builder对象。
text const char* 注释。
length size_t 注释长度。

# xml_builder_on_end 函数

  • 函数功能：

解析到tag结束时调用本函数。

  • 函数原型：
void xml_builder_on_end (XmlBuilder* builder, const char* tag);
  • 参数说明：
参数 类型 说明
返回值 void 返回无。
builder XmlBuilder* builder对象。
tag const char* tag名称。

# xml_builder_on_error 函数

  • 函数功能：

解析遇到错误时调用本函数。

  • 函数原型：
void xml_builder_on_error (XmlBuilder* builder, int line, int col, const char* message);
  • 参数说明：
参数 类型 说明
返回值 void 返回无。
builder XmlBuilder* builder对象。
line int 出现错误的行。
col int 出现错误的列。
message const char* 错误信息。

# xml_builder_on_pi 函数

  • 函数功能：

解析到处理指令时调用本函数。

  • 函数原型：
void xml_builder_on_pi (XmlBuilder* builder, const char* tag, const char** attrs);
  • 参数说明：
参数 类型 说明
返回值 void 返回无。
builder XmlBuilder* builder对象。
tag const char* tag名称。
attrs const char** 属性列表。

# xml_builder_on_start 函数

  • 函数功能：

解析到tag开始时调用本函数。

  • 函数原型：
void xml_builder_on_start (XmlBuilder* builder, const char* tag, const char** attrs);
  • 参数说明：
参数 类型 说明
返回值 void 返回无。
builder XmlBuilder* builder对象。
tag const char* tag名称。
attrs const char** 属性列表。

# xml_builder_on_text 函数

  • 函数功能：

解析到文本时调用本函数。

  • 函数原型：
void xml_builder_on_text (XmlBuilder* builder, const char* text, size_t length);
  • 参数说明：
参数 类型 说明
返回值 void 返回无。
builder XmlBuilder* builder对象。
text const char* 文本。
length size_t 文本长度。

← XmlParser →