保存到文件 - XmlSaveToFile

函数简介

将XML文档保存到文件。

接口名称

XmlSaveToFile

DLL调用

int32_t XmlSaveToFile(int64_t doc, const char* filepath, int32_t compact, int32_t* err)

参数说明

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

错误码

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

示例

// 保存为格式化的XML文件
int32_t err = 0;
int64_t doc = XmlCreateDocument();
// ... 构建XML ...

int32_t result = XmlSaveToFile(doc, "output.xml", 0, &err);
if (result == 1) {
    printf("保存成功\n");
}
XmlFree(doc);

// 保存配置文件
int64_t doc = XmlCreateDocument();
int32_t err = 0;

XmlSetDeclaration(doc, "1.0", "UTF-8", 1, &err);

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

int64_t server = XmlCreateElement(doc, "server", &err);
XmlSetAttribute(server, "host", "localhost", &err);
XmlSetAttributeInt(server, "port", 8080, &err);
XmlAppendChild(root, server, &err);

// 保存为格式化文件
XmlSaveToFile(doc, "./config/server.xml", 0, &err);

XmlFree(doc);

返回值

返回值说明
0失败
1成功

注意事项

  • 如果文件已存在，会被覆盖
  • 如果目录不存在，保存会失败
  • compact=0 时保存格式化的XML
  • compact=1 时保存紧凑的XML
  • 支持相对路径和绝对路径
Last Updated: