释放XML文档 - XmlFree

函数简介

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

接口名称

XmlFree

DLL调用

int32_t XmlFree(int64_t doc);

参数说明

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

示例

int32_t err = 0;
int64_t doc = XmlParseFile("config.xml", &err);
if (doc != 0) {
    int64_t root = XmlGetRootElement(doc, &err);
    // ... 处理XML ...

    // 使用完毕后释放
    XmlFree(doc);
}

返回值

1 成功，0 失败。

注意事项

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