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
|
/*
* libini - Library to read INI configuration files
*
* Copyright (C) 2014 Paul Cercueil <paul@crapouillou.net>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*/
#ifndef __INI_H
#define __INI_H
#ifdef __cplusplus
extern "C" {
#endif
#ifdef _WIN32
# ifdef ini_EXPORTS
# define __api __declspec(dllexport)
# elif !defined(libini_STATIC)
# define __api __declspec(dllimport)
# else
# define __api
# endif
#elif __GNUC__ >= 4
# define __api __attribute__((visibility ("default")))
#else
# define __api
#endif
#include <stdlib.h>
struct INI;
__api struct INI *ini_open(const char *file);
__api struct INI *ini_open_mem(const char *buf, size_t len);
__api void ini_close(struct INI *ini);
/* Jump to the next section.
* if 'name' is set, the pointer passed as argument
* points to the name of the section. 'name_len' is set to the length
* of the char array.
* XXX: the pointer will be invalid as soon as ini_close() is called.
*
* Returns:
* -EIO if an error occurred while reading the file,
* 0 if no more section can be found,
* 1 otherwise.
*/
__api int ini_next_section(struct INI *ini,
const char **name, size_t *name_len);
/* Read a key/value pair.
* 'key' and 'value' must be valid pointers. The pointers passed as arguments
* will point to the key and value read. 'key_len' and 'value_len' are
* set to the length of their respective char arrays.
* XXX: the pointers will be invalid as soon as ini_close() is called.
*
* Returns:
* -EIO if an error occurred while reading the file,
* 0 if no more key/value pairs can be found,
* 1 otherwise.
*/
__api int ini_read_pair(struct INI *ini,
const char **key, size_t *key_len,
const char **value, size_t *value_len);
/* Set the read head to a specified offset. */
__api void ini_set_read_pointer(struct INI *ini, const char *pointer);
/* Get the number of the line that contains the specified address.
*
* Returns:
* -EINVAL if the pointer points outside the INI string,
* The line number otherwise.
*/
__api int ini_get_line_number(struct INI *ini, const char *pointer);
#ifdef __cplusplus
}
#endif
#undef __api
#endif /* __INI_H */
|
