inifile-cpp：一个高效易用的C++ INI文件处理器

inifile-cpp：一个高效易用的C++ INI文件处理器

安装指南

inifile-cpp是一个简洁高效的、单头文件式的INI文件编码与解码库，它为C++开发者提供了快速处理配置文件的解决方案。要安装这个库，你可以选择以下两种途径：

1. 使用CMake构建系统：

   • 进入项目根目录：cd <path-to-repo>
   • 创建一个构建目录并进入：mkdir build && cd build
   • 执行CMake配置并安装：cmake .. && make install

2. 直接整合到项目中：

   • 将inicpp.h头文件复制到你的项目，并直接在代码中包含。

项目使用说明

快速上手

对于希望快速开始使用的用户，inifile-cpp提供了简单直观的API。通过查看examples/目录下的示例代码，您可以迅速了解如何根据自己的需求扩展该库。

加载数据

您可以从任何std::istream对象加载数据，只需调用函数或利用构造函数的重载：

#include <inicpp.h>
ini::IniFile myIni;
myIni.decode(is); // 函数调用
ini::IniFile anotherIni(is); // 构造函数使用

直接加载文件也非常简便：

myIni.load("example.ini");

开启多行值支持

如需解析跨越多行的值，启用setMultiLineValues(true)选项：

myIni.setMultiLineValues(true);
myIni.load("multiline.ini");

访问和转换字段

可以直接访问字段，并将其转换为多种基本类型或字符串：

int number = myIni["Section"]["Number"].as<int>();
std::string text = myIni["Section"]["Text"].as<std::string>();

类型转换与自定义类型

内建支持多种基础类型，且允许通过模板特化添加自定义类型的转换逻辑。例如，添加对std::vector的支持：

namespace ini
{
    template<typename T>
    struct Convert<std::vector<T>> // 实现细节省略，参照文档中的完整示例。
}

写入配置

赋值给字段后，您可以轻松地将配置内容写回流或文件：

myIni["NewSection"]["Key"] = "Value";
myIni.encode(os); // 写入流
myIni.save("output.ini"); // 直接保存到文件

API使用文档概览

• 解码：通过decode(std::istream&)方法从输入流加载数据。
• 编码：使用encode(std::ostream&)将内容写回到输出流。
• 加载与保存：通过load(const std::string&)加载文件，以及save(const std::string&)保存到文件。
• 访问字段：使用数组下标语法section[key]访问字段，利用.as<T>()转换为指定类型。
• 自定义类型转换：通过在ini命名空间内特化Convert<T>结构体，支持更多类型。

inifile-cpp旨在简化配置文件的操作，无论是读取还是写入，都力图做到既便捷又强大，适合集成进各种C++项目之中。