创建空XML文档 - XmlCreateDocument

函数简介

创建一个新的空XML文档对象。

接口名称

XmlCreateDocument

DLL调用

int64_t XmlCreateDocument()

参数说明

无参数

示例

// 创建空XML文档
int64_t doc = XmlCreateDocument();
if (doc != 0) {
    // 创建根元素
    int32_t err = 0;
    int64_t root = XmlCreateElement(doc, "root", &err);
    XmlInsertRootElement(doc, root, &err);
    
    // 使用完毕后释放
    XmlFree(doc);
}

// 完整示例：创建配置文件
int64_t doc = XmlCreateDocument();
int32_t err = 0;

// 设置XML声明
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.xml", 0, &err);

// 释放文档
XmlFree(doc);

返回值

返回值类型说明
int64_t返回新创建的XML文档句柄，失败时返回0

注意事项

  • 创建的文档需要调用 XmlFree 释放资源
  • 新创建的文档是空的，需要手动添加根元素
  • 建议使用 XmlSetDeclaration 设置XML声明
  • 文档句柄可以用于后续的所有XML操作
Last Updated: