【亲测免费】 `toml11`：现代C++的TOML解析器/编码器

1. 项目介绍

toml11 是一个现代C++（C++11及以上版本）的头文件库，用于解析和编码TOML配置文件。该项目由Toru Niina维护，其设计目标是高度兼容TOML语言规范并提供丰富的错误处理机制。toml11 支持自定义容器作为后端存储，可以选择保留原始注释，并提供了灵活的序列化选项。

2. 项目快速启动

安装

由于toml11是头文件库，因此不需要编译步骤。只需将include/toml11目录添加到您的项目头文件搜索路径即可开始使用。

示例

下面是一个简单的示例，展示如何使用toml11解析和打印一个TOML文件的内容：

#include <iostream>
#include <fstream>
#include <toml.hpp>

int main() {
    std::ifstream ifs("example.toml");
    if (!ifs.is_open()) {
        std::cerr << "Failed to open file" << std::endl;
        return 1;
    }

    try {
        const auto config = toml::parse(ifs);
        // 输出解析后的TOML数据结构
        std::cout << toml::dump(config) << std::endl;
    } catch (const toml::parse_error& e) {
        std::cerr << "Parse error occurred: " << e.what() << std::endl;
    }
    
    return 0;
}

确保替换example.toml为实际的TOML文件名，然后编译运行上述程序。

3. 应用案例和最佳实践

当你处理TOML配置时，以下是一些最佳实践:

• 使用toml::get_or函数来安全地获取配置值，同时提供默认值。
• 当不确定键是否存在时，利用toml::find或toml::find_or进行检查。
• 使用toml::try_parse避免异常处理，通过返回的toml::result对象检查解析是否成功。
• 自定义容器与toml11交互时，确保满足其随机访问容器的要求。

例如，要获取配置中的server.port，即使它未设置：

auto port = toml::get_or<int>(config.at("server").at("port"), 8080);

4. 典型生态项目

toml11因其易用性和灵活性，在许多C++项目中被广泛采用，例如：

• 开源游戏引擎如RPG Maker MV的插件开发
• 自动化工具和脚本，依赖于配置文件
• 数据分析和科学计算项目，用于配置参数

您可以在toml11的GitHub仓库的“相关项目”部分找到更多的生态示例。

---

以上是关于toml11的基本介绍，更多详细信息和高级用法可在其官方文档中查阅。祝您使用愉快！