2 * inih -- simple .INI file parser
4 * The "inih" library is distributed under the New BSD license:
6 * Copyright (c) 2009, Brush Technology - All rights reserved.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions are met:
11 * * Redistributions of source code must retain the above copyright notice,
12 * this list of conditions and the following disclaimer.
13 * * Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
16 * * Neither the name of Brush Technology nor the names of its contributors
17 * may be used to endorse or promote products derived from this software
18 * without specific prior written permission.
20 * THIS SOFTWARE IS PROVIDED BY BRUSH TECHNOLOGY ''AS IS'' AND ANY EXPRESS OR
21 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
22 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
23 * EVENT SHALL BRUSH TECHNOLOGY BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
25 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
26 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
27 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
28 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
29 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 * http://code.google.com/p/inih/
44 #define MAX_SECTION 50
47 /* Strip whitespace chars off end of given string, in place. Return s. */
48 static char* rstrip(char* s
)
50 char* p
= s
+ strlen(s
);
52 while (p
> s
&& isspace((unsigned char)(*--p
)))
57 /* Return pointer to first non-whitespace char in given string. */
58 static char* lskip(const char* s
)
60 while (*s
&& isspace((unsigned char)(*s
)))
66 * Return pointer to first char c or ';' comment in given string, or pointer to
67 * null at end of string if neither found. ';' must be prefixed by a whitespace
68 * character to register as a comment.
70 static char* find_char_or_comment(const char* s
, char c
)
72 int was_whitespace
= 0;
74 while (*s
&& *s
!= c
&& !(was_whitespace
&& *s
== ';')) {
75 was_whitespace
= isspace((unsigned char)(*s
));
81 /* Version of strncpy that ensures dest (size bytes) is null-terminated. */
82 static char* strncpy0(char* dest
, const char* src
, size_t size
)
84 strncpy(dest
, src
, size
);
85 dest
[size
- 1] = '\0';
89 /* See documentation in header file. */
91 int ini_parse_file(FILE* file
, ini_entry_handler handler
, void* user
)
93 /* Uses a fair bit of stack (use heap instead if you need to) */
95 char line
[INI_MAX_LINE
];
99 char section
[MAX_SECTION
] = "";
100 char prev_name
[MAX_NAME
] = "";
110 line
= (char*)zmalloc(INI_MAX_LINE
);
116 /* Scan through file line by line */
117 while (fgets(line
, INI_MAX_LINE
, file
) != NULL
) {
122 if (lineno
== 1 && (unsigned char)start
[0] == 0xEF &&
123 (unsigned char)start
[1] == 0xBB &&
124 (unsigned char)start
[2] == 0xBF) {
128 start
= lskip(rstrip(start
));
130 if (*start
== ';' || *start
== '#') {
132 * Per Python ConfigParser, allow '#' comments at
136 #if INI_ALLOW_MULTILINE
137 else if (*prev_name
&& *start
&& start
> line
) {
138 /* Non-black line with leading whitespace, treat as
139 * continuation of previous name's value
140 * (as per Python ConfigParser).
142 if (handler(user
, section
, prev_name
, start
) < 0 &&
148 else if (*start
== '[') {
149 /* A "[section]" line */
150 end
= find_char_or_comment(start
+ 1, ']');
153 strncpy0(section
, start
+ 1, sizeof(section
));
157 /* No ']' found on section line */
161 else if (*start
&& *start
!= ';') {
162 /* Not a comment, must be a name[=:]value pair */
163 end
= find_char_or_comment(start
, '=');
165 end
= find_char_or_comment(start
, ':');
167 if (*end
== '=' || *end
== ':') {
169 name
= rstrip(start
);
170 value
= lskip(end
+ 1);
171 end
= find_char_or_comment(value
, '\0');
179 * Valid name[=:]value pair found, call
182 strncpy0(prev_name
, name
, sizeof(prev_name
));
183 if (handler(user
, section
, name
, value
) < 0 &&
189 /* No '=' or ':' found on name[=:]value line */
202 /* See documentation in header file. */
204 int ini_parse(const char* filename
, ini_entry_handler handler
, void* user
)
209 file
= fopen(filename
, "r");
214 error
= ini_parse_file(file
, handler
, user
);