释放XML文档 - XmlFree

函数简介

释放XML文档对象及其占用的所有资源。

接口名称

XmlFree

DLL调用

int32_t XmlFree(int64_t doc)

参数说明

参数名类型说明
docint64_t要释放的XML文档句柄

示例

// 基本用法
int64_t doc = XmlCreateDocument();
// ... 使用XML文档 ...
XmlFree(doc);

// 完整示例
int32_t err = 0;
int64_t doc = XmlParseFile("config.xml", &err);
if (doc != 0) {
    int64_t root = XmlGetRootElement(doc, &err);
    // ... 处理XML ...
    
    // 使用完毕后释放
    XmlFree(doc);
}

// 错误处理
int64_t doc = XmlParse(xmlStr, &err);
if (doc != 0) {
    // 处理XML
    int64_t root = XmlGetRootElement(doc, &err);
    if (root != 0) {
        // ... 操作 ...
    }
    // 无论操作是否成功，都要释放文档
    XmlFree(doc);
}

返回值

返回值说明
0失败
1成功

注意事项

  • 释放文档后，所有相关的元素句柄都会失效
  • 必须在程序结束前释放所有创建的XML文档
  • 重复释放同一个文档会导致错误
  • 释放文档会自动释放其包含的所有元素和属性
  • 建议在使用完XML文档后立即释放
Last Updated: