/* 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 "firmware.h"
#include "languages.h"

#define MAX_LINE 100
#define MAX_SECTION LP_MAX_WORD /*32*/
#define MAX_NAME    LP_MAX_WORD /*32*/


typedef int (*ini_line_handler)(void* user, int lineno, const char* section, const char* name, const char* value);
typedef int (*ini_section_handler)(void* user, int lineno, const char* section);

/* 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), or -1 on file open error.

   0xAF: added section parameter, pass the section name to get only this section parsed
   if you want the whole file parsed, pass NULL
   0xAF: added a section handler, which will be called when new section is found.
   the return from this handler is the same like the name/value handler
*/
int ini_parse(const char* filename, const char* wanted_section, ini_line_handler handler, ini_section_handler shandler, void* user);

/* Same as ini_parse(), but takes a FD instead of filename. This doesn't
   close the file when it's finished -- the caller must do that. */
int ini_parse_file(int fd, const char* wanted_section, ini_line_handler handler, ini_section_handler shandler, 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

#ifdef __cplusplus
}
#endif

#endif /* __INI_H__ */
