MiniXML中文文档.docVIP

Mini-XML 入门 这一章描述了如何写一个程序使用Mini-XML来访问XML文件中的数据.Mini-XML提供了以下功能: 在内存中创建和管理XML文档的函数. 读UTF-8和UTF-16 编码的XML文件和字符串. 写UTF-8 编码的XML文件和字符串. 支持任意的元素名称，属性以及属性值，没有任何其他限制，仅受限于有效内存. 支持整形、浮点、自定义(CDATA)和文本数据类型在叶节点. 提供查找、索引、以及步进函数可以很简单的访问XML文档中的数据. Mini-XML 不进行基于XML方案(SCHEMA)文件或者其他内容源定义信息的校验和其他类型的处理 ,也不支持其他组织所要求的XML规范. 基础知识 Mini-XML 提供的一个你需要包含的头文件: #include mxml.h 把Mini-XML库连接到你的应用程序使用-lmxml 选项: gcc -o myprogram myprogram.c -lmxml ENTER 如果你已经安装pkg-config(1) 软件, 你可以使用它来为你的安装确定适当的编译和连接选项: pkg-config --cflags mxml ENTER pkg-config --libs mxml ENTER 节点 每一块XML文件中的信息片断(元素、文本、数字)是一个存储在内存中的节点(nodes) .节点使用mxml_node_t 结构进行定义. 它的type 成员变量定义了节点类型（element, integer, opaque, real, or text) 决定了需要从联合(union)类型的成员变量value 中获取的值. 表 2-1: Mini-XML 节点值的成员变量值 类型 节点成员 用户定义 void * node-value.custom.data XML元素 char * node- 整数 int node-eger 不透明字符串 char * node-value.opaque 浮点数 double node-value.real 文本 char * node-value.text.string 译者：节点类型定义枚举参见：mxml_type_e。 Mini-XML中的节点类型定义和其他有些解析器有些不同，其中整数、浮点、和文本节点是指在一个XML元素中一系列的使用空格作为分割的值，每个元素 可以拥有多个以上节点，并可以选择使用空格分开，如：abcaa bb cc/abc，Mini-MXML在使用参数：MXML_TEXT_CALLBACK进行载入时，将在abc元素下面生成3个text类 型的子节点。在创建时也可以使用同样的方式创建节点。整数和浮点也是同样方式，但如果转换失败则MiniXML报错。而不透明字符串类型(OPAQUE) 则不进行字符串分割，在载入时需要使用MXML_OPAQUE_CALLBACK参数，将所有字符串形成一个子节点。详情见：使用加载回调函数。 Z.F 每一个节点总是有一个成员变量:user_data 可以允许你为每一个节点关联你需要的应用数据. 新的节点可以使用以下函数进行创建 mxmlNewElement, mxmlNewInteger, mxmlNewOpaque, mxmlNewReal, mxmlNewText mxmlNewTextf mxmlNewXML . 只有 elements 可以拥有子节点，顶级节点必须是一个 element , 通常是?xml version=1.0? 使用mxmlNewXML()函数创建的节点. 每个节点都有一些关联节点的指针，上(parent), 下(child), 左(prev), and 右(next) 相对应于当前节点. 如果你有一个XML文件如下所示: ?xml version=1.0? data nodeval1/node nodeval2/node nodeval3/node group nodeval4/node nodeval5/node nodeval6/node /group nodeval7/node nodeval8/node /data 那么在内存中的文件节点树看上去如下所示: ?xml | data | node - node - node - group - node - node | | | | |