inih (INI Not Invented Here) is a simple .INI file parser written in C. It's only a couple of pages of code, and it was designed to be small and simple, so it's good for embedded systems. It's also more or less compatible with Python's ConfigParser style of .INI files, including RFC 822-style multi-line syntax and name: value
entries.
To use it, just give ini_parse()
an INI file, and it will call a callback for every name=value
pair parsed, giving you strings for the section, name, and value. It's done this way ("SAX style") because it works well on low-memory embedded systems, but also because it makes for a KISS implementation.
You can also call ini_parse_file()
to parse directly from a FILE*
object, ini_parse_string()
to parse data from a string, or ini_parse_stream()
to parse using a custom fgets-style reader function for custom I/O.
Download a release, browse the source, or read about how to use inih in a DRY style with X-Macros.
You can control various aspects of inih using preprocessor defines:
-DINI_ALLOW_MULTILINE=0
.-DINI_ALLOW_BOM=0
.;
character. To disable, add -DINI_ALLOW_INLINE_COMMENTS=0
. You can also specify which character(s) start an inline comment using INI_INLINE_COMMENT_PREFIXES
.;
and #
to start a comment at the beginning of a line. You can override this by changing INI_START_COMMENT_PREFIXES
.-DINI_STOP_ON_FIRST_ERROR=1
.ini_handler
callback doesn't receive the line number as a parameter. If you need that, add -DINI_HANDLER_LINENO=1
.name=value
pair. To detect new sections (e.g., the INI file has multiple sections with the same name), add -DINI_CALL_HANDLER_ON_NEW_SECTION=1
. Your handler function will then be called each time a new section is encountered, with section
set to the new section name but name
and value
set to NULL.malloc
instead, specify -DINI_USE_STACK=0
.-DINI_MAX_LINE=1000
. Note that INI_MAX_LINE
must be 3 more than the longest line (due to \r
, \n
, and the NUL).-DINI_USE_STACK=0
), inih allocates a fixed-sized buffer of INI_INITIAL_ALLOC
bytes. To allow this to grow to INI_MAX_LINE
bytes, doubling if needed, set -DINI_ALLOW_REALLOC=1
.INI_INITIAL_ALLOC
specifies the initial malloc size when using the heap. It defaults to 200 bytes.#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "../ini.h"
typedef struct
{
int version;
const char* name;
const char* email;
} configuration;
static int handler(void* user, const char* section, const char* name,
const char* value)
{
configuration* pconfig = (configuration*)user;
#define MATCH(s, n) strcmp(section, s) == 0 && strcmp(name, n) == 0
if (MATCH("protocol", "version")) {
pconfig->version = atoi(value);
} else if (MATCH("user", "name")) {
pconfig->name = strdup(value);
} else if (MATCH("user", "email")) {
pconfig->email = strdup(value);
} else {
return 0; /* unknown section/name, error */
}
return 1;
}
int main(int argc, char* argv[])
{
configuration config;
if (ini_parse("test.ini", handler, &config) < 0) {
printf("Can't load 'test.ini'\n");
return 1;
}
printf("Config loaded from 'test.ini': version=%d, name=%s, email=%s\n",
config.version, config.name, config.email);
return 0;
}
If you're into C++ and the STL, there is also an easy-to-use INIReader class that stores values in a map
and lets you Get()
them:
#include <iostream>
#include "INIReader.h"
int main()
{
INIReader reader("../examples/test.ini");
if (reader.ParseError() < 0) {
std::cout << "Can't load 'test.ini'\n";
return 1;
}
std::cout << "Config loaded from 'test.ini': version="
<< reader.GetInteger("protocol", "version", -1) << ", name="
<< reader.Get("user", "name", "UNKNOWN") << ", email="
<< reader.Get("user", "email", "UNKNOWN") << ", pi="
<< reader.GetReal("user", "pi", -1) << ", active="
<< reader.GetBoolean("user", "active", true) << "\n";
return 0;
}
This simple C++ API works fine, but it's not very fully-fledged. I'm not planning to work more on the C++ API at the moment, so if you want a bit more power (for example GetSections()
and GetFields()
functions), see these forks:
Some differences between inih and Python's ConfigParser standard library module:
_wfopen()
to open a file and then ini_parse_file()
to parse it; inih does not include wchar_t
or Unicode handling.此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。