1562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project/** @mainpage 2562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 3562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h1> TinyXml </h1> 4562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 5562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml is a simple, small, C++ XML parser that can be easily 6562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectintegrating into other programs. 7562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 8562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h2> What it does. </h2> 9562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 10562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectIn brief, TinyXml parses an XML document, and builds from that a 11562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectDocument Object Model (DOM) that can be read, modified, and saved. 12562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 13562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectXML stands for "eXtensible Markup Language." It allows you to create 14562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectyour own document markups. Where HTML does a very good job of marking 15562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectdocuments for browsers, XML allows you to define any kind of document 16562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectmarkup, for example a document that describes a "to do" list for an 17562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectorganizer application. XML is a very structured and convenient format. 18562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectAll those random file formats created to store application data can 19562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectall be replaced with XML. One parser for everything. 20562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 21562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThe best place for the complete, correct, and quite frankly hard to 22562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectread spec is at <a href="http://www.w3.org/TR/2004/REC-xml-20040204/"> 23562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projecthttp://www.w3.org/TR/2004/REC-xml-20040204/</a>. An intro to XML 24562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project(that I really like) can be found at 25562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<a href="http://skew.org/xml/tutorial/">http://skew.org/xml/tutorial</a>. 26562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 27562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThere are different ways to access and interact with XML data. 28562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml uses a Document Object Model (DOM), meaning the XML data is parsed 29562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectinto a C++ objects that can be browsed and manipulated, and then 30562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectwritten to disk or another output stream. You can also construct an XML document from 31562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectscratch with C++ objects and write this to disk or another output 32562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectstream. 33562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 34562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml is designed to be easy and fast to learn. It is two headers 35562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectand four cpp files. Simply add these to your project and off you go. 36562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThere is an example file - xmltest.cpp - to get you started. 37562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 38562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml is released under the ZLib license, 39562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectso you can use it in open source or commercial code. The details 40562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectof the license are at the top of every source file. 41562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 42562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml attempts to be a flexible parser, but with truly correct and 43562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectcompliant XML output. TinyXml should compile on any reasonably C++ 44562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectcompliant system. It does not rely on exceptions or RTTI. It can be 45562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectcompiled with or without STL support. TinyXml fully supports 46562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectthe UTF-8 encoding, and the first 64k character entities. 47562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 48562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 49562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h2> What it doesn't do. </h2> 50562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 51562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectIt doesnt parse or use DTDs (Document Type Definitions) or XSLs 52562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project(eXtensible Stylesheet Language.) There are other parsers out there 53562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project(check out www.sourceforge.org, search for XML) that are much more fully 54562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectfeatured. But they are also much bigger, take longer to set up in 55562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectyour project, have a higher learning curve, and often have a more 56562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectrestrictive license. If you are working with browsers or have more 57562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectcomplete XML needs, TinyXml is not the parser for you. 58562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 59562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThe following DTD syntax will not parse at this time in TinyXml: 60562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 61562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 62562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project <!DOCTYPE Archiv [ 63562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project <!ELEMENT Comment (#PCDATA)> 64562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project ]> 65562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 66562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 67562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectbecause TinyXml sees this as a !DOCTYPE node with an illegally 68562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectembedded !ELEMENT node. This may be addressed in the future. 69562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 70562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h2> Tutorials. </h2> 71562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 72562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectFor the impatient, here is a tutorial to get you going. A great way to get started, 73562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectbut it is worth your time to read this (very short) manual completely. 74562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 75562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project- @subpage tutorial0 76562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 77562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h2> Code Status. </h2> 78562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 79562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml is mature, tested code. It is very stable. If you find 80562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectbugs, please file a bug report on the sourceforge web site 81562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project(www.sourceforge.net/projects/tinyxml). 82562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectWe'll get them straightened out as soon as possible. 83562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 84562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThere are some areas of improvement; please check sourceforge if you are 85562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectinterested in working on TinyXml. 86562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 87562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 88562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h2> Features </h2> 89562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 90562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h3> Using STL </h3> 91562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 92562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml can be compiled to use or not use STL. When using STL, TinyXml 93562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectuses the std::string class, and fully supports std::istream, std::ostream, 94562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectoperator<<, and operator>>. Many API methods have both 'const char*' and 95562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project'const std::string&' forms. 96562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 97562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectWhen STL support is compiled out, no STL files are included whatsover. All 98562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectthe string classes are implemented by TinyXml itself. API methods 99562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectall use the 'const char*' form for input. 100562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 101562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectUse the compile time #define: 102562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 103562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TIXML_USE_STL 104562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 105562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectto compile one version or the other. This can be passed by the compiler, 106562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projector set as the first line of "tinyxml.h". 107562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 108562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectNote: If compiling the test code in Linux, setting the environment 109562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectvariable TINYXML_USE_STL=YES/NO will control STL compilation. In the 110562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectWindows project file, STL and non STL targets are provided. In your project, 111562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectits probably easiest to add the line "#define TIXML_USE_STL" as the first 112562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectline of tinyxml.h. 113562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 114562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h3> UTF-8 </h3> 115562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 116562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml supports UTF-8 allowing to manipulate XML files in any language. TinyXml 117562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectalso supports "legacy mode" - the encoding used before UTF-8 support and 118562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectprobably best described as "extended ascii". 119562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 120562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectNormally, TinyXml will try to detect the correct encoding and use it. However, 121562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectby setting the value of TIXML_DEFAULT_ENCODING in the header file, TinyXml 122562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectcan be forced to always use one encoding. 123562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 124562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml will assume Legacy Mode until one of the following occurs: 125562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<ol> 126562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project <li> If the non-standard but common "UTF-8 lead bytes" (0xef 0xbb 0xbf) 127562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project begin the file or data stream, TinyXml will read it as UTF-8. </li> 128562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project <li> If the declaration tag is read, and it has an encoding="UTF-8", then 129562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TinyXml will read it as UTF-8. </li> 130562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project <li> If the declaration tag is read, and it has no encoding specified, then 131562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TinyXml will read it as UTF-8. </li> 132562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project <li> If the declaration tag is read, and it has an encoding="something else", then 133562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TinyXml will read it as Legacy Mode. In legacy mode, TinyXml will 134562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project work as it did before. It's not clear what that mode does exactly, but 135562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project old content should keep working.</li> 136562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project <li> Until one of the above criteria is met, TinyXml runs in Legacy Mode.</li> 137562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project</ol> 138562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 139562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectWhat happens if the encoding is incorrectly set or detected? TinyXml will try 140562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectto read and pass through text seen as improperly encoded. You may get some strange 141562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectresults or mangled characters. You may want to force TinyXml to the correct mode. 142562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 143562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<b> You may force TinyXml to Legacy Mode by using LoadFile( TIXML_ENCODING_LEGACY ) or 144562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectLoadFile( filename, TIXML_ENCODING_LEGACY ). You may force it to use legacy mode all 145562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectthe time by setting TIXML_DEFAULT_ENCODING = TIXML_ENCODING_LEGACY. Likewise, you may 146562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectforce it to TIXML_ENCODING_UTF8 with the same technique.</b> 147562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 148562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectFor English users, using English XML, UTF-8 is the same as low-ASCII. You 149562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectdon't need to be aware of UTF-8 or change your code in any way. You can think 150562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectof UTF-8 as a "superset" of ASCII. 151562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 152562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectUTF-8 is not a double byte format - but it is a standard encoding of Unicode! 153562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml does not use or directly support wchar, TCHAR, or Microsofts _UNICODE at this time. 154562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectIt is common to see the term "Unicode" improperly refer to UTF-16, a wide byte encoding 155562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectof unicode. This is a source of confusion. 156562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 157562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectFor "high-ascii" languages - everything not English, pretty much - TinyXml can 158562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projecthandle all languages, at the same time, as long as the XML is encoded 159562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectin UTF-8. That can be a little tricky, older programs and operating systems 160562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projecttend to use the "default" or "traditional" code page. Many apps (and almost all 161562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectmodern ones) can output UTF-8, but older or stubborn (or just broken) ones 162562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectstill output text in the default code page. 163562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 164562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectFor example, Japanese systems traditionally use SHIFT-JIS encoding. 165562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectText encoded as SHIFT-JIS can not be read by tinyxml. 166562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectA good text editor can import SHIFT-JIS and then save as UTF-8. 167562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 168562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThe <a href="http://skew.org/xml/tutorial/">Skew.org link</a> does a great 169562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectjob covering the encoding issue. 170562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 171562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThe test file "utf8test.xml" is an XML containing English, Spanish, Russian, 172562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectand Simplified Chinese. (Hopefully they are translated correctly). The file 173562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project"utf8test.gif" is a screen capture of the XML file, rendered in IE. Note that 174562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectif you don't have the correct fonts (Simplified Chinese or Russian) on your 175562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectsystem, you won't see output that matches the GIF file even if you can parse 176562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectit correctly. Also note that (at least on my Windows machine) console output 177562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectis in a Western code page, so that Print() or printf() cannot correctly display 178562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectthe file. This is not a bug in TinyXml - just an OS issue. No data is lost or 179562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectdestroyed by TinyXml. The console just doesn't render UTF-8. 180562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 181562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 182562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h3> Entities </h3> 183562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml recognizes the pre-defined "character entities", meaning special 184562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectcharacters. Namely: 185562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 186562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 187562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project & & 188562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project < < 189562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project > > 190562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project " " 191562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project ' ' 192562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 193562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 194562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThese are recognized when the XML document is read, and translated to there 195562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectUTF-8 equivalents. For instance, text with the XML of: 196562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 197562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 198562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project Far & Away 199562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 200562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 201562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectwill have the Value() of "Far & Away" when queried from the TiXmlText object, 202562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectand will be written back to the XML stream/file as an ampersand. Older versions 203562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectof TinyXml "preserved" character entities, but the newer versions will translate 204562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectthem into characters. 205562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 206562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectAdditionally, any character can be specified by its Unicode code point: 207562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThe syntax " " or " " are both to the non-breaking space characher. 208562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 209562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 210562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h3> Streams </h3> 211562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectWith TIXML_USE_STL on, 212562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTiXml has been modified to support both C (FILE) and C++ (operator <<,>>) 213562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectstreams. There are some differences that you may need to be aware of. 214562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 215562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectC style output: 216562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project - based on FILE* 217562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project - the Print() and SaveFile() methods 218562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 219562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project Generates formatted output, with plenty of white space, intended to be as 220562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project human-readable as possible. They are very fast, and tolerant of ill formed 221562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project XML documents. For example, an XML document that contains 2 root elements 222562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project and 2 declarations, will still print. 223562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 224562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectC style input: 225562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project - based on FILE* 226562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project - the Parse() and LoadFile() methods 227562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 228562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project A fast, tolerant read. Use whenever you don't need the C++ streams. 229562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 230562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectC++ style ouput: 231562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project - based on std::ostream 232562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project - operator<< 233562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 234562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project Generates condensed output, intended for network transmission rather than 235562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project readability. Depending on your system's implementation of the ostream class, 236562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project these may be somewhat slower. (Or may not.) Not tolerant of ill formed XML: 237562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project a document should contain the correct one root element. Additional root level 238562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project elements will not be streamed out. 239562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 240562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectC++ style input: 241562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project - based on std::istream 242562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project - operator>> 243562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 244562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project Reads XML from a stream, making it useful for network transmission. The tricky 245562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project part is knowing when the XML document is complete, since there will almost 246562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project certainly be other data in the stream. TinyXml will assume the XML data is 247562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project complete after it reads the root element. Put another way, documents that 248562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project are ill-constructed with more than one root element will not read correctly. 249562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project Also note that operator>> is somewhat slower than Parse, due to both 250562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project implementation of the STL and limitations of TinyXml. 251562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 252562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h3> White space </h3> 253562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThe world simply does not agree on whether white space should be kept, or condensed. 254562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectFor example, pretend the '_' is a space, and look at "Hello____world". HTML, and 255562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectat least some XML parsers, will interpret this as "Hello_world". They condense white 256562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectspace. Some XML parsers do not, and will leave it as "Hello____world". (Remember 257562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectto keep pretending the _ is a space.) Others suggest that __Hello___world__ should become 258562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectHello___world. 259562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 260562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectIt's an issue that hasn't been resolved to my satisfaction. TinyXml supports the 261562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectfirst 2 approaches. Call TiXmlBase::SetCondenseWhiteSpace( bool ) to set the desired behavior. 262562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThe default is to condense white space. 263562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 264562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectIf you change the default, you should call TiXmlBase::SetCondenseWhiteSpace( bool ) 265562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectbefore making any calls to Parse XML data, and I don't recommend changing it after 266562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectit has been set. 267562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 268562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 269562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h3> Handles </h3> 270562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 271562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectWhere browsing an XML document in a robust way, it is important to check 272562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectfor null returns from method calls. An error safe implementation can 273562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectgenerate a lot of code like: 274562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 275562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 276562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTiXmlElement* root = document.FirstChildElement( "Document" ); 277562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectif ( root ) 278562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project{ 279562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlElement* element = root->FirstChildElement( "Element" ); 280562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project if ( element ) 281562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project { 282562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlElement* child = element->FirstChildElement( "Child" ); 283562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project if ( child ) 284562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project { 285562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlElement* child2 = child->NextSiblingElement( "Child" ); 286562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project if ( child2 ) 287562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project { 288562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project // Finally do something useful. 289562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 290562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 291562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectHandles have been introduced to clean this up. Using the TiXmlHandle class, 292562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectthe previous code reduces to: 293562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 294562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 295562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTiXmlHandle docHandle( &document ); 296562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTiXmlElement* child2 = docHandle.FirstChild( "Document" ).FirstChild( "Element" ).Child( "Child", 1 ).Element(); 297562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectif ( child2 ) 298562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project{ 299562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project // do something useful 300562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 301562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 302562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectWhich is much easier to deal with. See TiXmlHandle for more information. 303562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 304562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 305562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h3> Row and Column tracking </h3> 306562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectBeing able to track nodes and attributes back to their origin location 307562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectin source files can be very important for some applications. Additionally, 308562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectknowing where parsing errors occured in the original source can be very 309562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projecttime saving. 310562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 311562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml can tracks the row and column origin of all nodes and attributes 312562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectin a text file. The TiXmlBase::Row() and TiXmlBase::Column() methods return 313562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectthe origin of the node in the source text. The correct tabs can be 314562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectconfigured in TiXmlDocument::SetTabSize(). 315562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 316562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 317562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h2> Using and Installing </h2> 318562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 319562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTo Compile and Run xmltest: 320562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 321562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectA Linux Makefile and a Windows Visual C++ .dsw file is provided. 322562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectSimply compile and run. It will write the file demotest.xml to your 323562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectdisk and generate output on the screen. It also tests walking the 324562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectDOM by printing out the number of nodes found using different 325562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projecttechniques. 326562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 327562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThe Linux makefile is very generic and will 328562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectprobably run on other systems, but is only tested on Linux. You no 329562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectlonger need to run 'make depend'. The dependecies have been 330562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projecthard coded. 331562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 332562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h3>Windows project file for VC6</h3> 333562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<ul> 334562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<li>tinyxml: tinyxml library, non-STL </li> 335562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<li>tinyxmlSTL: tinyxml library, STL </li> 336562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<li>tinyXmlTest: test app, non-STL </li> 337562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<li>tinyXmlTestSTL: test app, STL </li> 338562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project</ul> 339562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 340562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h3>Linux Make file</h3> 341562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectAt the top of the makefile you can set: 342562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 343562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectPROFILE, DEBUG, and TINYXML_USE_STL. Details (such that they are) are in 344562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectthe makefile. 345562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 346562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectIn the tinyxml directory, type "make clean" then "make". The executable 347562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectfile 'xmltest' will be created. 348562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 349562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 350562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 351562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h3>To Use in an Application:</h3> 352562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 353562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectAdd tinyxml.cpp, tinyxml.h, tinyxmlerror.cpp, tinyxmlparser.cpp, tinystr.cpp, and tinystr.h to your 354562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectproject or make file. That's it! It should compile on any reasonably 355562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectcompliant C++ system. You do not need to enable exceptions or 356562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectRTTI for TinyXml. 357562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 358562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 359562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h2> How TinyXml works. </h2> 360562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 361562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectAn example is probably the best way to go. Take: 362562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 363562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project <?xml version="1.0" standalone=no> 364562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project <!-- Our to do list data --> 365562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project <ToDo> 366562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project <Item priority="1"> Go to the <bold>Toy store!</bold></Item> 367562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project <Item priority="2"> Do bills</Item> 368562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project </ToDo> 369562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 370562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 371562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectIts not much of a To Do list, but it will do. To read this file 372562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project(say "demo.xml") you would create a document, and parse it in: 373562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 374562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlDocument doc( "demo.xml" ); 375562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project doc.LoadFile(); 376562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 377562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 378562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectAnd its ready to go. Now lets look at some lines and how they 379562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectrelate to the DOM. 380562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 381562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 382562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<?xml version="1.0" standalone=no> 383562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 384562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 385562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project The first line is a declaration, and gets turned into the 386562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlDeclaration class. It will be the first child of the 387562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project document node. 388562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 389562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project This is the only directive/special tag parsed by by TinyXml. 390562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project Generally directive targs are stored in TiXmlUnknown so the 391562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project commands wont be lost when it is saved back to disk. 392562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 393562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 394562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<!-- Our to do list data --> 395562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 396562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 397562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project A comment. Will become a TiXmlComment object. 398562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 399562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 400562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<ToDo> 401562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 402562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 403562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project The "ToDo" tag defines a TiXmlElement object. This one does not have 404562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project any attributes, but does contain 2 other elements. 405562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 406562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 407562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<Item priority="1"> 408562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 409562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 410562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project Creates another TiXmlElement which is a child of the "ToDo" element. 411562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project This element has 1 attribute, with the name "priority" and the value 412562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project "1". 413562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 414562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectGo to the 415562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 416562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project A TiXmlText. This is a leaf node and cannot contain other nodes. 417562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project It is a child of the "Item" TiXmlElement. 418562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 419562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 420562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<bold> 421562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 422562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 423562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 424562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project Another TiXmlElement, this one a child of the "Item" element. 425562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 426562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectEtc. 427562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 428562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectLooking at the entire object tree, you end up with: 429562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@verbatim 430562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTiXmlDocument "demo.xml" 431562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlDeclaration "version='1.0'" "standalone=no" 432562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlComment " Our to do list data" 433562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlElement "ToDo" 434562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlElement "Item" Attribtutes: priority = 1 435562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlText "Go to the " 436562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlElement "bold" 437562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlText "Toy store!" 438562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlElement "Item" Attributes: priority=2 439562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project TiXmlText "Do bills" 440562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project@endverbatim 441562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 442562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h2> Documentation </h2> 443562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 444562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThe documentation is build with Doxygen, using the 'dox' 445562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectconfiguration file. 446562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 447562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h2> License </h2> 448562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 449562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml is released under the zlib license: 450562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 451562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThis software is provided 'as-is', without any express or implied 452562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectwarranty. In no event will the authors be held liable for any 453562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectdamages arising from the use of this software. 454562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 455562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectPermission is granted to anyone to use this software for any 456562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectpurpose, including commercial applications, and to alter it and 457562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectredistribute it freely, subject to the following restrictions: 458562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 459562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project1. The origin of this software must not be misrepresented; you must 460562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectnot claim that you wrote the original software. If you use this 461562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectsoftware in a product, an acknowledgment in the product documentation 462562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectwould be appreciated but is not required. 463562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 464562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project2. Altered source versions must be plainly marked as such, and 465562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectmust not be misrepresented as being the original software. 466562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 467562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project3. This notice may not be removed or altered from any source 468562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectdistribution. 469562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 470562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h2> References </h2> 471562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 472562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThe World Wide Web Consortium is the definitive standard body for 473562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectXML, and there web pages contain huge amounts of information. 474562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 475562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThe definitive spec: <a href="http://www.w3.org/TR/2004/REC-xml-20040204/"> 476562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projecthttp://www.w3.org/TR/2004/REC-xml-20040204/</a> 477562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 478562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectI also recommend "XML Pocket Reference" by Robert Eckstein and published by 479562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectOReilly...the book that got the whole thing started. 480562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 481562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project<h2> Contributors, Contacts, and a Brief History </h2> 482562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 483562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectThanks very much to everyone who sends suggestions, bugs, ideas, and 484562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectencouragement. It all helps, and makes this project fun. A special thanks 485562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectto the contributors on the web pages that keep it lively. 486562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 487562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectSo many people have sent in bugs and ideas, that rather than list here 488562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectwe try to give credit due in the "changes.txt" file. 489562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 490562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectTinyXml was originally written be Lee Thomason. (Often the "I" still 491562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectin the documenation.) Lee reviews changes and releases new versions, 492562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectwith the help of Yves Berquin and the tinyXml community. 493562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 494562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectWe appreciate your suggestions, and would love to know if you 495562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectuse TinyXml. Hopefully you will enjoy it and find it useful. 496562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectPlease post questions, comments, file bugs, or contact us at: 497562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 498562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Projectwww.sourceforge.net/projects/tinyxml 499562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project 500562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectLee Thomason, 501562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source ProjectYves Berquin 502562be06492c3ac43adf153f550abaede6bc18a44The Android Open Source Project*/ 503