How to handle UTF-8 INI files with SimpleIni on Linux?

Set Unicode mode with ini.SetUnicode() and load or save files in UTF-8 encoding; SimpleIni handles conversion independently of system locale, making it reliable across platforms.

SimpleIni vs inih for C++ INI parsing?

SimpleIni offers a fuller API with saving, comments preservation, and multiple encodings, while inih is lighter and faster for read-only scenarios. Choose based on need for editing features versus minimal footprint.

Can SimpleIni preserve comments when editing INI files?

Yes, it's designed to preserve comments at file, section, and key levels during load and save operations, maintaining the original structure as documented in the feature summary.

How to handle duplicate keys in SimpleIni?

Enable optional support for multiple keys with the same name, then use GetAllValues to retrieve all instances and SetValue to manage them, with control over order via sorting.

Is SimpleIni good for embedded systems like WinCE?

Yes, it's tested on WinCE and other platforms, with a lightweight, header-only design that minimizes dependencies, making it suitable for resource-constrained environments.

How to integrate SimpleIni into a CMake project?

Add it as a subdirectory with add_subdirectory and link using target_link_libraries, or install system-wide and use find_package, as detailed in the CMake integration section.

Open-Awesome

simpleini

MITC++v4.25

A cross-platform C++ library for reading and writing INI-style configuration files with a simple API.

GitHub

1.3k stars355 forks0 contributors

What is simpleini?

SimpleIni is a cross-platform C++ library that provides a simple API for reading and writing INI-style configuration files. It solves the problem of managing application settings by offering a lightweight, portable solution that supports various file encodings and formats without complex dependencies.

Target Audience

C++ developers who need a reliable, easy-to-integrate library for handling configuration files in desktop, embedded, or cross-platform applications.

Value Proposition

Developers choose SimpleIni for its header-only design, MIT license, and robust support for multiple platforms and encodings, making it a versatile and hassle-free alternative to rolling custom INI parsers.

Overview

Cross-platform C++ library providing a simple API to read and write INI-style configuration files

Use Cases

Best For

Managing application settings in cross-platform C++ projects
Parsing INI files with non-ASCII characters or UTF-8 encoding
Embedded systems or WinCE applications requiring configuration files
Projects needing a lightweight, header-only configuration library
Preserving comments and order in INI files during edits
Handling multi-line values or duplicate keys in configuration data

Not Ideal For

Projects requiring configuration in structured formats like JSON, YAML, or XML
Applications that need in-memory configuration management without persistent file I/O
Teams seeking built-in data validation or schema enforcement for configuration files
Environments where compile-time bloat from header-only libraries is a critical concern

Pros & Cons

Pros

Cross-Platform Reliability

Tested on Windows from 95 to 11, CE, Linux, and macOS, ensuring consistent behavior across diverse environments without platform-specific quirks.

Encoding Flexibility

Supports ASCII, MBCS, and UTF-8 encodings with liberal acceptance of file formats, including non-ASCII characters and multi-line values, as highlighted in the feature summary.

Data Preservation

Preserves comments and the original order of sections and keys when saving files, maintaining file structure and human readability, which is a key advertised feature.

Header-Only Ease

As a header-only library, it requires no building or linking, simplifying integration into C++ projects with just an include directive, per the installation notes.

Cons

Format Limitation

Only handles INI-style files, lacking native support for modern configuration formats like JSON or YAML, which may be necessary for complex or nested data structures.

Advanced Encoding Setup

Using non-default character converters, such as SI_CONVERT_GENERIC, requires manual inclusion of external files like ConvertUTF.*, adding integration complexity as noted in the README.

No Built-in Validation

Focuses on file I/O without features for data type validation, schema definitions, or error checking, requiring additional code for robust configuration management.

Frequently Asked Questions

Related Projects

inih

Simple .INI file parser in C, good for embedded systems

Stars2,960

Forks561

Last commit2 months ago

toml++

Header-only TOML config file parser and serializer for C++17.

Stars2,037

Forks195

Last commit11 days ago

toml11

TOML for Modern C++

Stars1,265

Forks187

Last commit4 months ago

libconfig

C/C++ Library for Processing Structured Configuration Files

Stars1,205

Forks380