获取根元素 - XmlGetRootElement

函数简介

获取XML文档的根元素。

接口名称

XmlGetRootElement

DLL调用

int64_t XmlGetRootElement(int64_t doc, int32_t* err)

参数说明

参数名	类型	说明
doc	int64_t	XML文档句柄
err	int32_t*	错误码输出参数，可为NULL

示例

int32_t err = 0;
int64_t doc = XmlParseFile("config.xml", &err);
if (doc != 0) {
    int64_t root = XmlGetRootElement(doc, &err);
    if (root != 0) {
        const char* name = XmlGetElementName(root, &err);
        printf("根元素：%s\n", name);
        FreeStringPtr(instance, name);
    }
    XmlFree(doc);
}

返回值

返回值类型	说明
int64_t	返回根元素句柄，失败时返回0

注意事项

• 如果文档没有根元素，返回0
• 根元素句柄在文档释放后失效