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 * SPDX-License-Identifier: BSD-3-Clause
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions are met:
13 * * Redistributions of source code must retain the above copyright notice,
14 * this list of conditions and the following disclaimer.
15 * * Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 * * Neither the name of Brush Technology nor the names of its contributors
19 * may be used to endorse or promote products derived from this software
20 * without specific prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY BRUSH TECHNOLOGY ''AS IS'' AND ANY EXPRESS OR
23 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
24 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
25 * EVENT SHALL BRUSH TECHNOLOGY BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
27 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
28 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
29 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
30 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
31 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 * http://code.google.com/p/inih/
38 #include <common/common.hpp>
48 #define MAX_SECTION 50
51 /* Strip whitespace chars off end of given string, in place. Return s. */
52 static char *rstrip(char *s
)
54 char *p
= s
+ strlen(s
);
56 while (p
> s
&& isspace((unsigned char) (*--p
)))
61 /* Return pointer to first non-whitespace char in given string. */
62 static char *lskip(const char *s
)
64 while (*s
&& isspace((unsigned char) (*s
)))
70 * Return pointer to first char c or ';' comment in given string, or pointer to
71 * null at end of string if neither found. ';' must be prefixed by a whitespace
72 * character to register as a comment.
74 static char *find_char_or_comment(const char *s
, char c
)
76 int was_whitespace
= 0;
78 while (*s
&& *s
!= c
&& !(was_whitespace
&& *s
== ';')) {
79 was_whitespace
= isspace((unsigned char) (*s
));
85 /* Version of strncpy that ensures dest (size bytes) is null-terminated. */
86 static char *strncpy0(char *dest
, const char *src
, size_t size
)
88 strncpy(dest
, src
, size
- 1);
89 dest
[size
- 1] = '\0';
93 /* See documentation in header file. */
94 int ini_parse_file(FILE *file
, ini_entry_handler handler
, void *user
)
96 /* Uses a fair bit of stack (use heap instead if you need to) */
98 char line
[INI_MAX_LINE
];
102 char section
[MAX_SECTION
] = "";
103 char prev_name
[MAX_NAME
] = "";
113 line
= zmalloc
<char>(INI_MAX_LINE
);
119 /* Scan through file line by line */
120 while (fgets(line
, INI_MAX_LINE
, file
) != nullptr) {
125 if (lineno
== 1 && (unsigned char) start
[0] == 0xEF &&
126 (unsigned char) start
[1] == 0xBB && (unsigned char) start
[2] == 0xBF) {
130 start
= lskip(rstrip(start
));
132 if (*start
== ';' || *start
== '#') {
134 * Per Python ConfigParser, allow '#' comments at
138 #if INI_ALLOW_MULTILINE
139 else if (*prev_name
&& *start
&& start
> line
) {
140 /* Non-black line with leading whitespace, treat as
141 * continuation of previous name's value
142 * (as per Python ConfigParser).
144 if (handler(user
, section
, prev_name
, start
) < 0 && !error
) {
149 else if (*start
== '[') {
150 /* A "[section]" line */
151 end
= find_char_or_comment(start
+ 1, ']');
154 strncpy0(section
, start
+ 1, sizeof(section
));
157 /* No ']' found on section line */
160 } else if (*start
&& *start
!= ';') {
161 /* Not a comment, must be a name[=:]value pair */
162 end
= find_char_or_comment(start
, '=');
164 end
= find_char_or_comment(start
, ':');
166 if (*end
== '=' || *end
== ':') {
168 name
= rstrip(start
);
169 value
= lskip(end
+ 1);
170 end
= find_char_or_comment(value
, '\0');
178 * Valid name[=:]value pair found, call
181 if (strlen(name
) >= sizeof(prev_name
)) {
182 /* Truncation occurs, report an error. */
185 strncpy0(prev_name
, name
, sizeof(prev_name
));
186 if (handler(user
, section
, name
, value
) < 0 && !error
) {
190 /* No '=' or ':' found on name[=:]value line */
203 /* 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
);