TinyXML 指南 二

开始

把文件加载成XML

把一个文件加载成TinyXML DOM的最简单方法是：

TiXmlDocument doc( "demo.xml"
);

doc.LoadFile();
一个更接近于现实应用的例子如下。它加载文件并把内容显示到标准输出STDOUT上：

// 加载指定的文件并把它的结构输出到STDOUT上

void
dump_to_stdout(const char
* pFilename)

{

TiXmlDocument doc(pFilename);

bool
loadOkay = doc.LoadFile();

if
(loadOkay)

{

printf("/n%s:/n"
, pFilename);

dump_to_stdout( &doc ); // 稍后在指南中定义

}

else

{

printf("Failed to load file /"
%s/”/n", pFilename);

}

}
在main中使用此函数的一个简单应用示范如下：

int
main(void
)

{

dump_to_stdout("example1.xml"
);

return
0;

}
回想example1的XML：

<?xml version="1.0" ?>

<Hello>World</Hello>
用这个XML运行程序就会在控制台/DOS窗口中显示：

DOCUMENT

+ DECLARATION

+ ELEMENT Hello

+ TEXT[World]
”dump_to_stdout“函数稍后会在这份指南中定义，如果你想要理解怎样递归遍历一个DOM它会很有用。

用程序建立文档对象

这是用程序建立example1的方法：

void
build_simple_doc( )

{

// 生成xml: <?xml ..><Hello>World</Hello>

TiXmlDocument doc;

TiXmlDeclaration * decl = new
TiXmlDeclaration( "1.0"
, ""
, ""
);

TiXmlElement * element = new
TiXmlElement( "Hello"
);

TiXmlText * text = new
TiXmlText( "World"
);

element->LinkEndChild( text );

doc.LinkEndChild( decl );

doc.LinkEndChild( element );

doc.SaveFile( "madeByHand.xml"
);

}
然后可以用以下方法加载并显示在控制台上：

dump_to_stdout("madeByHand.xml"
); // 此函数稍后会中指南中定义

你会看到跟example1一模一样：

madeByHand.xml:

Document

+ Declaration

+ Element [Hello]

+ Text: [World]
这段代码会产生相同的XML DOM，但它以不同的顺序来创建和链接结点：

void
write_simple_doc2( )

{

// 实现与 write_simple_doc1一样的功能，(译注：我想它指是build_simple_doc
)

// 但尽可能早地把结点添加到树中。

TiXmlDocument doc;

TiXmlDeclaration * decl = new
TiXmlDeclaration( "1.0"
, ""
, ""
);

doc.LinkEndChild( decl );

TiXmlElement * element = new
TiXmlElement( "Hello"
);

doc.LinkEndChild( element );

TiXmlText * text = new
TiXmlText( "World"
);

element->LinkEndChild( text );

doc.SaveFile( "madeByHand2.xml"
);

}
两个都产生同样的XML，即：

<?xml version="1.0" ?>

<Hello>World</Hello>
结构构成都是：

DOCUMENT

+ DECLARATION

+ ELEMENT Hello

+ TEXT[World]
属性

给定一个存在的结点，设置它的属性是很容易的：

window = new
TiXmlElement( "Demo"
);

window->SetAttribute("name"
, "Circle"
);

window->SetAttribute("x"
, 5);

window->SetAttribute("y"
, 15);

window->SetDoubleAttribute("radius"
, 3.14159);
你也可以用TiXmlAttribute对象达到同样的目的。

下面的代码向我们展示了一种（并不只有一种）获取某一元素属性并打印出它们的名字和字符串值的方法，如果值能够被转化为整型数或者浮点数，也把值打印出来：

// 打印pElement的所有属性。

// 返回已打印的属性数量。

int
dump_attribs_to_stdout(TiXmlElement* pElement, unsigned
int
indent)

{

if
( !pElement ) return
0;

TiXmlAttribute* pAttrib=pElement->FirstAttribute();

int
i=0;

int
ival;

double
dval;

const char
* pIndent=getIndent(indent);

printf("/n"
);

while
(pAttrib)

{

printf( "%s%s: value=[%s]"
, pIndent, pAttrib->Name(), pAttrib->Value());

if
(pAttrib->QueryIntValue(&ival)==TIXML_SUCCESS) printf( " int=%d"
, ival);

if
(pAttrib->QueryDoubleValue(&dval)==TIXML_SUCCESS) printf( " d=%1.1f"
, dval);

printf( "/n"
);

i++;

pAttrib=pAttrib->Next();

}

return
i;

}
把文档对象写到文件中

把一个已经建立好的DOM写到文件中是非常简单的：

doc.SaveFile( saveFilename );
回想一下，比如example4：

<?xml version="1.0" ?>

<MyApp>

<!– Settings for MyApp –>

<Messages>

<Welcome>Welcome to MyApp</Welcome>

<Farewell>Thank you for using MyApp</Farewell>

</Messages>

<Windows>

<Window name="MainFrame" x="5" y="15" w="400" h="250" />

</Windows>

<Connection ip="192.168.0.1" timeout="123.456000" />

</MyApp>
以下函数建立这个DOM并把它写到“appsettings.xml”文件中：

void
write_app_settings_doc( )

{

TiXmlDocument doc;

TiXmlElement* msg;

TiXmlDeclaration* decl = new
TiXmlDeclaration( "1.0"
, ""
, ""
);

doc.LinkEndChild( decl );

TiXmlElement * root = new
TiXmlElement( "MyApp"
);

doc.LinkEndChild( root );

TiXmlComment * comment = new
TiXmlComment();

comment->SetValue(" Settings for MyApp "
);

root->LinkEndChild( comment );

TiXmlElement * msgs = new
TiXmlElement( "Messages"
);

root->LinkEndChild( msgs );

msg = new
TiXmlElement( "Welcome"
);

msg->LinkEndChild( new
TiXmlText( "Welcome to MyApp"
));

msgs->LinkEndChild( msg );

msg = new
TiXmlElement( "Farewell"
);

msg->LinkEndChild( new
TiXmlText( "Thank you for using MyApp"
));

msgs->LinkEndChild( msg );

TiXmlElement * windows = new
TiXmlElement( "Windows"
);

root->LinkEndChild( windows );

TiXmlElement * window;

window = new
TiXmlElement( "Window"
);

windows->LinkEndChild( window );

window->SetAttribute("name"
, "MainFrame"
);

window->SetAttribute("x"
, 5);

window->SetAttribute("y"
, 15);

window->SetAttribute("w"
, 400);

window->SetAttribute("h"
, 250);

TiXmlElement * cxn = new
TiXmlElement( "Connection"
);

root->LinkEndChild( cxn );

cxn->SetAttribute("ip"
, "192.168.0.1"
);

cxn->SetDoubleAttribute("timeout"
, 123.456); // 浮点数属性

dump_to_stdout( &doc );

doc.SaveFile( "appsettings.xml"
);

}
dump_to_stdout函数将显示如下结构：

Document

+ Declaration

+ Element [MyApp]

(No attributes)

+ Comment: [ Settings for MyApp ]

+ Element [Messages]

(No attributes)

+ Element [Welcome]

(No attributes)

+ Text: [Welcome to MyApp]

+ Element [Farewell]

(No attributes)

+ Text: [Thank you for using MyApp]

+ Element [Windows]

(No attributes)

+ Element [Window]

+ name: value=[MainFrame]

+ x: value=[5] int=5 d=5.0

+ y: value=[15] int=15 d=15.0

+ w: value=[400] int=400 d=400.0

+ h: value=[250] int=250 d=250.0

5 attributes

+ Element [Connection]

+ ip: value=[192.168.0.1] int=192 d=192.2

+ timeout: value=[123.456000] int=123 d=123.5

2 attributes
TinyXML默认以其它APIs称作“pretty”格式的方式来输出XML，对此我感到惊讶。这种格式修改了元素的文本结点中的空格，以使输出来的结点树包含一个嵌套层标记。

我还没有仔细看当写到一个文件中时是否有办法关闭这种缩进——这肯定很容易做到。（译注：这两句话大概是Ellers说的
）

[Lee：在STL模式下这很容易做到，只需要cout << myDoc就行了。在非STL模式下就总是用“pretty”格式了，加多一个开关是一个很好的特性，这已经被要求过了。]