解析XML字符串 - XmlParse

函数简介

解析XML格式的字符串，生成XML文档对象。

接口名称

XmlParse

DLL调用

int64_t XmlParse(const char* str, int32_t* err)

参数说明

参数名类型说明
strstring要解析的XML字符串
errint32_t*错误码输出参数，可为NULL

错误码

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

示例

// 解析简单的XML字符串
const char* xmlStr = "<root><item>Hello</item></root>";
int32_t err = 0;
int64_t doc = XmlParse(xmlStr, &err);
if (doc != 0 && err == 0) {
    // 解析成功，进行操作
    int64_t root = XmlGetRootElement(doc, &err);
    // ... 其他操作 ...
    XmlFree(doc);
} else {
    printf("解析失败，错误码：%d\n", err);
}

// 解析复杂的XML
const char* configXml = 
    "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
    "<config>\n"
    "  <server host=\"localhost\" port=\"8080\"/>\n"
    "  <database>\n"
    "    <connection>mysql://localhost:3306</connection>\n"
    "  </database>\n"
    "</config>";

int32_t err = 0;
int64_t doc = XmlParse(configXml, &err);
if (doc != 0) {
    // 读取配置
    int64_t root = XmlGetRootElement(doc, &err);
    int64_t server = XmlFindElement(root, "server", &err);
    
    const char* host = XmlGetAttribute(server, "host", &err);
    int32_t port = XmlGetAttributeInt(server, "port", &err);
    
    printf("服务器：%s:%d\n", host, port);
    
    FreeStringPtr(instance, host);
    XmlFree(doc);
}

返回值

返回值类型说明
int64_t返回解析后的XML文档句柄，失败时返回0

注意事项

  • 解析失败时返回0，可通过err参数获取错误码
  • 解析成功后需要调用 XmlFree 释放资源
  • 支持标准的XML格式，包括声明、注释、CDATA等
  • 字符串必须是有效的XML格式
  • 返回的字符串指针需要调用 FreeStringPtr 释放
Last Updated: