TinyXML-2
=========
[![TravisCI Status](https://travis-ci.org/leethomason/tinyxml2.svg?branch=master)](https://travis-ci.org/leethomason/tinyxml2) [![AppVeyor Status](https://ci.appveyor.com/api/projects/status/github/leethomason/tinyxml2?branch=master&svg=true)](https://ci.appveyor.com/project/leethomason/tinyxml2)
![TinyXML-2 Logo](http://www.grinninglizard.com/tinyxml2/TinyXML2_small.png)
TinyXML-2 is a simple, small, efficient, C++ XML parser that can be
easily integrated into other programs.
The master is hosted on github:
https://github.com/leethomason/tinyxml2
The online HTML version of these docs:
http://leethomason.github.io/tinyxml2/
Examples are in the "related pages" tab of the HTML docs.
What it does.
-------------
In brief, TinyXML-2 parses an XML document, and builds from that a
Document Object Model (DOM) that can be read, modified, and saved.
XML stands for "eXtensible Markup Language." It is a general purpose
human and machine readable markup language to describe arbitrary data.
All those random file formats created to store application data can
all be replaced with XML. One parser for everything.
http://en.wikipedia.org/wiki/XML
There are different ways to access and interact with XML data.
TinyXML-2 uses a Document Object Model (DOM), meaning the XML data is parsed
into a C++ objects that can be browsed and manipulated, and then
written to disk or another output stream. You can also construct an XML document
from scratch with C++ objects and write this to disk or another output
stream. You can even use TinyXML-2 to stream XML programmatically from
code without creating a document first.
TinyXML-2 is designed to be easy and fast to learn. It is one header and
one cpp file. Simply add these to your project and off you go.
There is an example file - xmltest.cpp - to get you started.
TinyXML-2 is released under the ZLib license,
so you can use it in open source or commercial code. The details
of the license are at the top of every source file.
TinyXML-2 attempts to be a flexible parser, but with truly correct and
compliant XML output. TinyXML-2 should compile on any reasonably C++
compliant system. It does not rely on exceptions, RTTI, or the STL.
What it doesn't do.
-------------------
TinyXML-2 doesn't parse or use DTDs (Document Type Definitions) or XSLs
(eXtensible Stylesheet Language.) There are other parsers out there
that are much more fully featured. But they are also much bigger,
take longer to set up in your project, have a higher learning curve,
and often have a more restrictive license. If you are working with
browsers or have more complete XML needs, TinyXML-2 is not the parser for you.
TinyXML-1 vs. TinyXML-2
-----------------------
TinyXML-2 is now the focus of all development, well tested, and your
best choice between the two APIs. At this point, unless you are maintaining
legacy code, you should choose TinyXML-2.
TinyXML-2 uses a similar API to TinyXML-1 and the same
rich test cases. But the implementation of the parser is completely re-written
to make it more appropriate for use in a game. It uses less memory, is faster,
and uses far fewer memory allocations.
TinyXML-2 has no requirement or support for STL. By returning `const char*`
TinyXML-2 can be much more efficient with memory usage. (TinyXML-1 did support
and use STL, but consumed much more memory for the DOM representation.)
Features
--------
### Code Page
TinyXML-2 uses UTF-8 exclusively when interpreting XML. All XML is assumed to
be UTF-8.
Filenames for loading / saving are passed unchanged to the underlying OS.
### Memory Model
An XMLDocument is a C++ object like any other, that can be on the stack, or
new'd and deleted on the heap.
However, any sub-node of the Document, XMLElement, XMLText, etc, can only
be created by calling the appropriate XMLDocument::NewElement, NewText, etc.
method. Although you have pointers to these objects, they are still owned
by the Document. When the Document is deleted, so are all the nodes it contains.
### White Space
#### Whitespace Preservation (default)
Microsoft has an excellent article on white space: http://msdn.microsoft.com/en-us/library/ms256097.aspx
By default, TinyXML-2 preserves white space in a (hopefully) sane way that is almost compliant with the
spec. (TinyXML-1 used a completely different model, much more similar to 'collapse', below.)
As a first step, all newlines / carriage-returns / line-feeds are normalized to a
line-feed character, as required by the XML spec.
White space in text is preserved. For example:
<element> Hello, World</element>
The leading space before the "Hello" and the double space after the comma are
preserved. Line-feeds are preserved, as in this example:
<element> Hello again,
World</element>
However, white space between elements is **not** preserved. Although not strictly
compliant, tracking and reporting inter-element space is awkward, and not normally
valuable. TinyXML-2 sees these as the same XML:
<document>
<data>1</data>
<data>2</data>
<data>3</data>
</document>
<document><data>1</data><data>2</data><data>3</data></document>
#### Whitespace Collapse
For some applications, it is preferable to collapse whitespace. Collapsing
whitespace gives you "HTML-like" behavior, which is sometimes more suitable
for hand typed documents.
TinyXML-2 supports this with the 'whitespace' parameter to the XMLDocument constructor.
(The default is to preserve whitespace, as described above.)
However, you may also use COLLAPSE_WHITESPACE, which will:
* Remove leading and trailing whitespace
* Convert newlines and line-feeds into a space character
* Collapse a run of any number of space characters into a single space character
Note that (currently) there is a performance impact for using COLLAPSE_WHITESPACE.
It essentially causes the XML to be parsed twice.
#### Error Reporting
TinyXML-2 reports the line number of any errors in an XML document that
cannot be parsed correctly. In addition, all nodes (elements, declarations,
text, comments etc.) and attributes have a line number recorded as they are parsed.
This allows an application that performs additional validation of the parsed
XML document (e.g. application-implemented DTD validation) to report
line number information for error messages.
### Entities
TinyXML-2 recognizes the pre-defined "character entities", meaning special
characters. Namely:
& &
< <
> >
" "
' '
These are recognized when the XML document is read, and translated to their
UTF-8 equivalents. For instance, text with the XML of:
Far & Away
will have the Value() of "Far & Away" when queried from the XMLText object,
and will be written back to the XML stream/file as an ampersand.
Additionally, any character can be specified by its Unicode code point:
The syntax ` ` or ` ` are both to the non-breaking space character.
This is called a 'numeric character reference'. Any numeric character reference
that isn't one of the special entities above, will be read, but written as a
regular code point. The output is correct, but the entity syntax isn't preserved.
### Printing
#### Print to file
You can directly use the convenience function:
XMLDocument doc;
...
doc.SaveFile( "foo.xml" );
Or the XMLPrinter class:
XMLPrinter printer( fp );
doc.Print( &printer );
#### Print to memory
Printing to memory is supported by the XMLPrinter.
XMLPrinter printer;
doc.Print( &printer );
// printer.CStr() has a const char* to the XML
#### Print without an XMLDocument
When loading, an XML parser is very useful. However, sometimes
when saving, it just gets in the way. The code is often set up
for streaming, and constructing the DOM is just overhead.
The Printer supports the streaming case. The following code
prints out a trivially simple XML file without ever creating
an XML document.
XMLPrinter printer( fp );
printer.OpenElement( "foo" );
printer.PushAttribute( "foo", "bar" );
pri
没有合适的资源?快使用搜索试试~ 我知道了~
资源推荐
资源详情
资源评论
收起资源包目录
C++ XML文件解析库 tinyxml2 (204个子文件)
tinyxml2-cbp.cbp 1KB
biicode.conf 93B
xmltest.cpp 77KB
tinyxml2.cpp 72KB
html5-printer.cpp 4KB
doxygen.css 27KB
tabs.css 9KB
search.css 4KB
dox 107KB
tinyxml2.vcxproj.filters 293B
test.vcxproj.filters 218B
.gitignore 231B
tinyxml2.h 69KB
tinyxml2_8h_source.html 300KB
classtinyxml2_1_1_x_m_l_element.html 72KB
classtinyxml2_1_1_x_m_l_document.html 57KB
classtinyxml2_1_1_x_m_l_node.html 41KB
classtinyxml2_1_1_x_m_l_text.html 33KB
classtinyxml2_1_1_x_m_l_declaration.html 31KB
classtinyxml2_1_1_x_m_l_unknown.html 31KB
classtinyxml2_1_1_x_m_l_comment.html 31KB
classtinyxml2_1_1_x_m_l_element-members.html 27KB
classtinyxml2_1_1_x_m_l_printer.html 26KB
functions.html 25KB
functions_func.html 25KB
classtinyxml2_1_1_x_m_l_document-members.html 20KB
classtinyxml2_1_1_x_m_l_attribute.html 19KB
classtinyxml2_1_1_x_m_l_handle.html 17KB
index.html 15KB
classtinyxml2_1_1_x_m_l_text-members.html 13KB
classtinyxml2_1_1_x_m_l_declaration-members.html 13KB
classtinyxml2_1_1_x_m_l_comment-members.html 13KB
classtinyxml2_1_1_x_m_l_unknown-members.html 13KB
classtinyxml2_1_1_x_m_l_node-members.html 13KB
classtinyxml2_1_1_x_m_l_printer-members.html 11KB
classtinyxml2_1_1_x_m_l_visitor.html 11KB
classtinyxml2_1_1_x_m_l_attribute-members.html 10KB
classtinyxml2_1_1_x_m_l_handle-members.html 8KB
annotated.html 6KB
hierarchy.html 6KB
_example_3.html 6KB
classtinyxml2_1_1_x_m_l_visitor-members.html 6KB
_example_4.html 5KB
classes.html 4KB
classtinyxml2_1_1_x_m_l_const_handle.html 4KB
pages.html 4KB
_example_2.html 3KB
_example_1.html 3KB
classtinyxml2_1_1_x_m_l_const_handle-members.html 3KB
files.html 3KB
functions_12.html 1020B
functions_11.html 1020B
functions_10.html 1020B
functions_13.html 1020B
functions_d.html 1019B
functions_6.html 1019B
functions_1.html 1019B
functions_b.html 1019B
functions_4.html 1019B
functions_7.html 1019B
functions_8.html 1019B
functions_e.html 1019B
functions_a.html 1019B
functions_3.html 1019B
functions_f.html 1019B
functions_9.html 1019B
functions_0.html 1019B
functions_2.html 1019B
functions_c.html 1019B
functions_5.html 1019B
classes_0.html 1017B
pages_0.html 1015B
pages_3.html 1015B
pages_4.html 1015B
pages_1.html 1015B
pages_2.html 1015B
all_12.html 1014B
all_10.html 1014B
all_13.html 1014B
all_11.html 1014B
all_a.html 1013B
all_b.html 1013B
all_f.html 1013B
all_d.html 1013B
all_4.html 1013B
all_8.html 1013B
all_3.html 1013B
all_0.html 1013B
all_2.html 1013B
all_c.html 1013B
all_1.html 1013B
all_5.html 1013B
all_6.html 1013B
all_9.html 1013B
all_7.html 1013B
all_e.html 1013B
nomatches.html 461B
cmake_uninstall.cmake.in 1KB
tinyxml2.pc.in 263B
jquery.js 169KB
共 204 条
- 1
- 2
- 3
资源评论
kinglover0811
- 粉丝: 0
- 资源: 2
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
最新资源
- 微软常用运行库 游戏运行库 VC++各个版本
- 微信小程序开发教程.pptx
- MyBatis动态SQL是一种强大的特性,它允许我们在SQL语句中根据条件动态地添加或删除某些部分,从而实现更加灵活和高效的数据
- 锐捷网络认证中心网络管理.pdf
- MyBatis动态SQL是一种强大的特性,它允许我们在SQL语句中根据条件动态地添加或删除某些部分,从而实现更加灵活和高效的数据
- SD8233LF是一款用于单按键触摸及接近感应开关,其用途是替代传统的机械型开关芯片IC
- 基于YOLOv5的烟雾火焰检测算法研究
- 基于STM32的联合调试侦听设备解决方案原理图PCB源文件调试工具视频(大赛作品)
- MyBatis动态SQL是一种强大的特性,它允许我们在SQL语句中根据条件动态地添加或删除某些部分,从而实现更加灵活和高效的数据
- MyBatis动态SQL是一种强大的特性,它允许我们在SQL语句中根据条件动态地添加或删除某些部分,从而实现更加灵活和高效的数据
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功