README.md

ini

A tiny ANSI C library for loading .ini config files

Usage

The files ini.c and ini.h should be dropped into an existing project.

The library has support for sections, comment lines and quoted string values (with escapes). Unquoted values and keys are trimmed of whitespace when loaded.

; last modified 1 April 2001 by John Doe
[owner]
name = John Doe
organization = Acme Widgets Inc.

[database]
; use IP address in case network name resolution is not working
server = 192.0.2.62     
port = 143
file = "payroll.dat"

An ini file can be loaded into memory by using the ini_load() function. NULL is returned if the file cannot be loaded.

ini_t *config = ini_load("config.ini");

The library provides two functions for retrieving values: the first is ini_get(). Given a section and a key the corresponding value is returned if it exists. If the section argument is NULL then all sections are searched.

const char *name = ini_get(config, "owner", "name");
if (name) {
  printf("name: %s\n", name);
}

The second, ini_sget(), takes the same arguments as ini_get() with the addition of a scanf format string and a pointer for where to store the value.

const char *server = "default";
int port = 80;

ini_sget(config, "database", "server", NULL, &server);
ini_sget(config, "database", "port", "%d", &port);

printf("server: %s:%d\n", server, port);

The ini_free() function is used to free the memory used by the ini_t* object when we are done with it. Calling this function invalidates all string pointers returned by the library.

ini_free(config);

License

This library is free software; you can redistribute it and/or modify it under the terms of the MIT license. See LICENSE for details.