feather-ini-parser
Intuitive, fast, lightweight, header, portable INI parser for ANSI C++.
Methods
| Statement | Return Type |
|---|---|
| ini(filename, doParse, parseFlags) | constructor |
| ini(ini) | copy constructor |
| ini.parse(parseFlags) | bool |
| ini.save(filename, saveFlags) | bool |
| ini.set(section, key, value) | bool |
| ini.get(section, key, def) | string |
| ini.getAs<type>(section, key, def = type()) | type |
| ini.create(section) | bool |
| ini.select(section) | bool |
| ini.set(key, value) | bool |
| ini.get(key, def) | string |
| ini.getAs<type>(key, def = type()) | type |
| ini.clear() | bool |
| ini[section][key] | string& |
| ini[section] | keys_t& |
Flags
| Flag | Effect |
|---|---|
| PARSE_COMMENTS_ALL | Parses comments // and # |
| PARSE_COMMENTS_SLASH | Parses comment // |
| PARSE_COMMENTS_HASH | Parses comment # |
| SAVE_PRUNE | Removes all empty sections/keys |
| SAVE_PADDING_SECTIONS | Appends a blank line under each section |
| SAVE_SPACE_SECTIONS | '[ Section ]' instead of '[Section]' |
| SAVE_SPACE_KEYS | 'key = value' instead of 'key=value' |
| SAVE_TAB_KEYS | ' key=value' instead of 'key=value' |
| SAVE_SEMICOLON_KEYS | 'key=value;' instead of 'key=value' |
Example
Requires C++11: -std=c++11 or -std=c++14 or -std=c++20 or ...
#include "INI.h"
//#define FINI_WIDE_SUPPORT
...
// Set global parsing/saving options
INI::PARSE_FLAGS = INI::PARSE_COMMENTS_ALL | INI::PARSE_COMMENTS_SLASH | INI::PARSE_COMMENTS_HASH;
INI::SAVE_FLAGS = INI::SAVE_PRUNE | INI::SAVE_PADDING_SECTIONS | INI::SAVE_SPACE_SECTIONS | INI::SAVE_SPACE_KEYS | INI::SAVE_TAB_KEYS | INI::SAVE_SEMICOLON_KEYS;
INI ini("file.ini", true); // Assign ini file and parse
ini.create("Section 0");
ini.select("Section 0");
ini.set("Key2", "Value");
ini.get("Key1", "DefaultValue");
ini.set("Section 0", "Key1", std::to_string(11.12));
cout << ini.getAs<float>("Section 2", "Key1") << endl; // Return as float
ini["Section 0"]["Key1"] = "Changed";
// Save with formatting
ini.save("test.ini");
// Loop through sections, keys and values
for(auto i: ini.sections) {
cout << "[" << i.first << "]" << endl;
//for(auto j = i.second->begin(); j != i.second->end(); j++)
for(auto j: *i.second) {
cout << " " << j.first << "=" << j.second << endl;
}
}More
Please see the example .cpp file and Code::Blocks .cbp project for a compilable GCC and VSC++ example. Further examples include enabling wide char support.