78 lines
2.4 KiB
C
78 lines
2.4 KiB
C
|
/* inih -- simple .INI file parser
|
||
|
|
|
||
|
|
inih is released under the New BSD license (see LICENSE.txt). Go to the project
|
||
|
|
home page for more info:
|
||
|
|
|
||
|
|
http://code.google.com/p/inih/
|
||
|
|
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef __INI_H__
|
||
|
|
#define __INI_H__
|
||
|
|
|
||
|
|
/* Make this header file easier to include in C++ code */
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#include <stdio.h>
|
||
|
|
|
||
|
|
/* Parse given INI-style file. May have [section]s, name=value pairs
|
||
|
|
(whitespace stripped), and comments starting with ';' (semicolon). Section
|
||
|
|
is "" if name=value pair parsed before any section heading. name:value
|
||
|
|
pairs are also supported as a concession to Python's ConfigParser.
|
||
|
|
|
||
|
|
For each name=value pair parsed, call handler function with given user
|
||
|
|
pointer as well as section, name, and value (data only valid for duration
|
||
|
|
of handler call). Handler should return nonzero on success, zero on error.
|
||
|
|
|
||
|
|
Returns 0 on success, line number of first error on parse error (doesn't
|
||
|
|
stop on first error), -1 on file open error, or -2 on memory allocation
|
||
|
|
error (only when INI_USE_STACK is zero).
|
||
|
|
*/
|
||
|
|
int ini_parse(const char* filename,
|
||
|
|
int (*handler)(void* user, const char* section,
|
||
|
|
const char* name, const char* value),
|
||
|
|
void* user);
|
||
|
|
|
||
|
|
/* Same as ini_parse(), but takes a FILE* instead of filename. This doesn't
|
||
|
|
close the file when it's finished -- the caller must do that. */
|
||
|
|
int ini_parse_file(FILE* file,
|
||
|
|
int (*handler)(void* user, const char* section,
|
||
|
|
const char* name, const char* value),
|
||
|
|
void* user);
|
||
|
|
|
||
|
|
int ini_parse_str(char* ini_string,
|
||
|
|
int (*handler)(void*, const char*, const char*,
|
||
|
|
const char*),
|
||
|
|
void* user);
|
||
|
|
|
||
|
|
/* Nonzero to allow multi-line value parsing, in the style of Python's
|
||
|
|
ConfigParser. If allowed, ini_parse() will call the handler with the same
|
||
|
|
name for each subsequent line parsed. */
|
||
|
|
#ifndef INI_ALLOW_MULTILINE
|
||
|
|
#define INI_ALLOW_MULTILINE 1
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/* Nonzero to allow a UTF-8 BOM sequence (0xEF 0xBB 0xBF) at the start of
|
||
|
|
the file. See http://code.google.com/p/inih/issues/detail?id=21 */
|
||
|
|
#ifndef INI_ALLOW_BOM
|
||
|
|
#define INI_ALLOW_BOM 1
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/* Nonzero to use stack, zero to use heap (malloc/free). */
|
||
|
|
#ifndef INI_USE_STACK
|
||
|
|
#define INI_USE_STACK 1
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/* Maximum line length for any line in INI file. */
|
||
|
|
#ifndef INI_MAX_LINE
|
||
|
|
#define INI_MAX_LINE 200
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif /* __INI_H__ */
|