Ets_Xml_Export()
摘要
将指定的网络模型导出到 XML 文件。
语法
Ets_Xml_Export (model_hndl, output_filename, postproc_func, client_data_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
model_hndl |
EtsT_Model_Handle |
指定要导出为 XML 格式的网络模型。 |
output_filename |
const char * |
将要生成的 XML 文件的名称。 |
postproc_func |
EtsT_Xml_Export_Postproc_Func |
在基础 XML 数据生成之后调用的回调函数。 |
client_data_ptr |
void * |
传递给每次 postproc_func 调用的状态指针。 |
返回类型
EtsT_Compcode
导出成功时返回 EtsC_Compcode_Success;导出过程中发生失败时返回 EtsC_Compcode_Failure。失败可能由内存耗尽、指定的目标文件路径无效等原因引起。
头文件
ets_api_xml.h
详情
该函数允许调用方将指定的内存中的网络模型转换为 XML 形式并存储到磁盘。调用方需提供要导出的模型、目标文件名,以及一个可对 XML 输出做进一步充实的后处理函数。
在导出过程中,应用程序首先生成指定网络模型的中间描述。该描述采用 World Wide Web Consortium(W3C)libxml 格式中的 xmlNode 数据结构。
骨架生成之后,后处理函数 postproc_func 会对每个对象调用一次,允许调用方为该对象的 XML 描述附加额外信息。后处理函数的原型见 EtsT_Xml_Export_Postproc_Func。
默认的后处理函数是 Nt_Xmle_Postproc_Default()。它接受一个客户端数据指针,可以指向任何用户自定义的结构。
XML schema(DTD)存储在 <reldir>/sys/etc/network.dtd。