1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
# ini
## Overview
**ini** is a simple C library for parsing and creating [INI files](https://en.wikipedia.org/wiki/INI_file). It possesses the following characteristics:
- Compatible with C89
- Has no external dependencies
INI files are commonly used to store configuration data, and our library makes it easy to read and write these files in C programs.
## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [Examples](#examples)
- [License](#license)
## Installation
To use this library in your own project, simply download the source code from the repository and link the `ini.c` and `ini.h` files with your project.
## Usage
This library provides a set of functions for reading and writing INI files. Here's an example of how to read an INI file:
```c
#include <stdio.h>
#include <stdlib.h>
#include "ini_file.h"
int main(const int argc, const char **const argv) {
struct Ini_File *ini_file;
size_t section_index, property_index;
char *value;
double number;
/* Check that the user provided an argument specifying the INI file name */
if (argc < 2) {
fprintf(stderr, "Usage: %s file_name.ini\n", argv[0]);
return EXIT_FAILURE;
}
/* Parse the INI file and store the resulting data structure in a variable */
ini_file = ini_file_parse(argv[1], NULL);
/* Check that the INI file was parsed successfully */
if (ini_file == NULL) {
fprintf(stderr, "Was not possible to parse the ini_file \"%s\"\n", argv[1]);
return EXIT_FAILURE;
}
/* Print the properties from the INI file to the console (useful for debug purposes) */
printf("\nThe properties retrieved from the the ini file \"%s\" are:\n\n", argv[1]);
ini_file_print_to(ini_file, stdout);
/* You can iterate over the sections and keys */
for (section_index = 0; section_index < ini_file->sections_size; section_index++) {
struct Ini_Section *section = &ini_file->sections[section_index];
printf("[%s]\n", section->name);
for (property_index = 0; property_index < section->properties_size; property_index++) {
struct Key_Value_Pair *property = §ion->properties[property_index];
printf("%s = %s\n", property->key, property->value);
}
printf("\n");
}
/* You can search for a property */
if (ini_file_find_property(ini_file, "section", "key", &value) != ini_no_error) {
fprintf(stderr, "\nIt was not possible to find the specified key!\n");
}
printf("\nThe specified key equals to: %s\n", value);
/* You can search for a property and convert it directly to a number */
if (ini_file_find_double(ini_file, "section", "key", &number) != ini_no_error) {
fprintf(stderr, "\nIt was not possible to find the specified key!\n");
}
printf("\nThe specified key equals to: %g\n", number);
/* Free the memory used by the INI file data structure */
ini_file_free(ini_file);
/* Return 0 to indicate success */
return EXIT_SUCCESS;
}
```
For a complete list of functions and their documentation, see the `ini.h` header file.
## Examples
In the examples folder, you can find complete examples of how to use the library. To compile them, simply type `make` at your terminal. Run the executables and follow the instructions provided.
## License
This project is released under the MIT license. See the LICENSE file for more information.
|
