序列化为字符串 - XmlToString
函数简介
将XML文档序列化为字符串。
接口名称
XmlToString
DLL调用
const char* XmlToString(int64_t doc, int32_t compact, int32_t* err);
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| doc | 长整数型 | XML文档句柄 |
| compact | 整数型 | 是否紧凑输出(0表示格式化,1表示紧凑) |
| err | 整数型 | 错误码输出参数,可为NULL |
示例
int32_t err = 0;
int64_t doc = XmlCreateDocument();
int64_t root = XmlCreateElement(doc, "root", &err);
XmlInsertRootElement(doc, root, &err);
int64_t item = XmlCreateElement(doc, "item", &err);
XmlSetElementText(item, "Hello World", &err);
XmlAppendChild(root, item, &err);
// 格式化输出
const char* xmlStr = XmlToString(doc, 0, &err);
printf("%s\n", xmlStr);
FreeStringPtr(instance, xmlStr);
// 紧凑输出
const char* compactStr = XmlToString(doc, 1, &err);
printf("%s\n", compactStr);
FreeStringPtr(instance, compactStr);
XmlFree(doc);
返回值
返回XML字符串指针,失败时返回NULL。需调用 FreeStringPtr 释放内存。
注意事项
- 返回的字符串需要调用
FreeStringPtr释放内存 - compact=0 时输出带缩进的格式化XML
- compact=1 时输出紧凑的单行XML
