创建元素 - XmlCreateElement
函数简介
创建新的XML元素。
接口名称
XmlCreateElement
DLL调用
int64_t XmlCreateElement(int64_t doc, const char* name, int32_t* err)
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| doc | int64_t | XML文档句柄 |
| name | string | 元素名称 |
| err | int32_t* | 错误码输出参数，可为NULL |
示例
int32_t err = 0;
int64_t doc = XmlCreateDocument();
// 创建根元素
int64_t root = XmlCreateElement(doc, "config", &err);
XmlInsertRootElement(doc, root, &err);
// 创建子元素
int64_t server = XmlCreateElement(doc, "server", &err);
XmlSetAttribute(server, "host", "localhost", &err);
XmlAppendChild(root, server, &err);
XmlFree(doc);
返回值
| 返回值类型 | 说明 |
|---|---|
| int64_t | 返回元素句柄，失败时返回0 |
注意事项
- 创建的元素需要添加到文档树中才能生效
- 元素名称不能为空
- 元素句柄在文档释放后失效