序列化为字符串 - XmlToString

函数简介

将XML文档序列化为字符串。

接口名称

XmlToString

DLL调用

const char* XmlToString(int64_t doc, int32_t compact, int32_t* err)

参数说明

参数名类型说明
docint64_tXML文档句柄
compactint32_t是否紧凑输出（0表示格式化，1表示紧凑）
errint32_t*错误码输出参数，可为NULL

错误码

错误码说明
0操作成功
1无效的句柄
2XML解析失败
3类型不匹配
4元素不存在
5属性不存在
6未知错误

示例

// 格式化输出
int32_t err = 0;
int64_t doc = XmlCreateDocument();
// ... 构建XML ...

const char* xmlStr = XmlToString(doc, 0, &err);  // 格式化输出
if (xmlStr != NULL) {
    printf("%s\n", xmlStr);
    FreeStringPtr(instance, xmlStr);
}
XmlFree(doc);

// 紧凑输出
const char* compactXml = XmlToString(doc, 1, &err);  // 紧凑输出
if (compactXml != NULL) {
    printf("%s\n", compactXml);
    FreeStringPtr(instance, compactXml);
}

// 完整示例
int64_t doc = XmlCreateDocument();
int32_t err = 0;

int64_t root = XmlCreateElement(doc, "root", &err);
XmlInsertRootElement(doc, root, &err);

int64_t item = XmlCreateElement(doc, "item", &err);
XmlSetElementText(item, "Hello World", &err);
XmlAppendChild(root, item, &err);

// 输出格式化的XML
const char* xmlStr = XmlToString(doc, 0, &err);
printf("格式化输出：\n%s\n", xmlStr);
FreeStringPtr(instance, xmlStr);

// 输出紧凑的XML
const char* compactStr = XmlToString(doc, 1, &err);
printf("紧凑输出：%s\n", compactStr);
FreeStringPtr(instance, compactStr);

XmlFree(doc);

返回值

返回值类型说明
string返回XML字符串，需调用FreeStringPtr释放，失败时返回NULL

注意事项

  • 返回的字符串需要调用 FreeStringPtr 释放内存
  • compact=0 时输出带缩进的格式化XML
  • compact=1 时输出紧凑的单行XML
  • 格式化输出适合阅读，紧凑输出适合传输
Last Updated: