TinyXML2的快速实践

Posted 2021-03-26 kenwoo

最近遇到个需要在C++中处理XML文件的需求，虽然对此方面并不是很熟，但好在有GitHub上的awesome-cpp项目的帮助，还是收获了足够的相关知识。

类库

常用的或被推荐的XML类库有以下数个选项，不过相较于纯C完成的类库个人还是更倾向于C++的类库：

• Boost.PropertyTree - A property tree parser/generator that can be used to parse XML/JSON/INI/Info files. [Boost]
• Expat - An XML parser library written in C. [MIT]
• Libxml2 - The XML C parser and toolkit of Gnome. [MIT]
• libxml++ - An XML Parser for C++. [LGPL2]
• Mini-XML - A small XML parsing library written in ANSI C. [LGPL2 with exceptions]
• PugiXML - A light-weight, simple and fast XML parser for C++ with XPath support. [MIT]
• RapidXml - An attempt to create the fastest XML parser possible, while retaining useability, portability and reasonable W3C compatibility. [Boost]
• TinyXML - A simple, small, minimal, C++ XML parser that can be easily integrating into other programs. [zlib]
• TinyXML2 - A simple, small, efficient, C++ XML parser that can be easily integrating into other programs. [zlib]
• TinyXML++ - A completely new interface to TinyXML that uses MANY of the C++ strengths. Templates, exceptions, and much better error handling. [MIT]
• Xerces-C++ - A validating XML parser written in a portable subset of C++. [Apache2]

TinyXML VS TinyXML2

TinyXML是在寻找更多信息时被多次提及的，因为并不想花费过多时间在做选择题上，于是其似乎成了最终的赢家。

但未曾想它自身还有两个版本。

TinyXML与TinyXML2的相同点：

• 简单的API
• 基于DOM的解析器
• 支持UTF-8 Unicode

TinyXML2的优点：

• 着眼于未来的开发
• 更少的内存分配(1/10到1/100)，使用更少的内存(TinyXML的40%)，更快(读取上约5倍)
• 不再需要STL
• 更现代的C++，包括一个合适的命名空间
• 适当且有用地处理空白

TinyXML的优点：

• 能够报告解析错误的位置
• 支持一些C++ STL约定：流与字符串
• 非常成熟并且调试良好的代码库

TinyXML2的第2及第4项优点是我更中意的，所以还是选它吧。

使用方法

在其GitHub的仓库中下载相关文件，tinyxml2

找到tinyxml2.h与tinyxml2.cpp两个文件，将它们添加至你的工程项目中，这便是所有需要的。

示例

#include <iostream>
#include <random>

#include "tinyxml2.h"
using namespace tinyxml2;

void writeXMLFile()
{
    XMLDocument doc;
    auto delaration = doc.NewDeclaration();
    doc.InsertFirstChild(delaration);

    auto root = doc.NewElement("root");
    doc.InsertEndChild(root);

    auto id = doc.NewElement("id");
    id->SetText(666);
    root->InsertEndChild(id);

    auto name = doc.NewElement("name");
    name->SetText("Ken");
    name->SetAttribute("blogger", true);
    root->InsertEndChild(name);

    doc.SaveFile("sample.xml");
}

XMLDocument* readXMLFile()
{
    auto doc = new XMLDocument;
    doc->LoadFile("sample.xml");

    auto root = doc->RootElement();
    auto id = root->FirstChildElement("id");
    
    std::cout << id->GetText() << std::endl;

    auto name = root->FirstChildElement("name");
    std::cout << name->GetText() << std::endl;
    std::cout << name->Attribute("blogger") << std::endl;

    return doc;
}

int main()
{
    writeXMLFile();
    auto doc = readXMLFile();
    auto root = doc->RootElement();
    auto id = root->FirstChildElement("id");
    doc->DeleteNode(id);

    auto randomid = doc->NewElement("randomid");
    
    std::default_random_engine e;
    std::uniform_int_distribution<int> u;
    auto r = u(e, decltype(u)::param_type(1000000, 9000000));

    randomid->SetText(r);
    root->InsertFirstChild(randomid);

    doc->Print();

    delete doc;
}