summaryrefslogtreecommitdiffstats
path: root/iniFile/iniFile.h
blob: 223e0237f7e2c7f85b2ff4b138da5cd054e8792a (plain) (blame)
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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
// IniFile.cpp:  Implementation of the CIniFile class.
// Written by:   Adam Clauss
// Email: cabadam@tamu.edu
// You may use this class/code as you wish in your programs.  Feel free to distribute it, and
// email suggested changes to me.
//
// Rewritten by: Shane Hill
// Date:         21/08/2001
// Email:        Shane.Hill@dsto.defence.gov.au
// Reason:       Remove dependancy on MFC. Code should compile on any
//               platform. Tested on Windows/Linux/Irix
//////////////////////////////////////////////////////////////////////

/*
!! MODIFIED BY FAKETRUTH and madmaxoft!!
*/

#ifndef CIniFile_H
#define CIniFile_H





#define MAX_KEYNAME    128
#define MAX_VALUENAME  128
#define MAX_VALUEDATA 2048





// tolua_begin

class cIniFile
{
private:
	bool        m_IsCaseInsensitive;
	
	struct key
	{
		std::vector<AString> names;
		std::vector<AString> values;
		std::vector<AString> comments;
	} ;
	
	std::vector<key>     keys;
	std::vector<AString> names;
	std::vector<AString> comments;
	
	/// If the object is case-insensitive, returns s as lowercase; otherwise returns s as-is
	AString CheckCase(const AString & s) const;

public:
	enum errors
	{
		noID = -1,
	};
	
	/// Creates a new instance with no data
	cIniFile(void);

	// Sets whether or not keynames and valuenames should be case sensitive.
	// The default is case insensitive.
	void CaseSensitive  (void) { m_IsCaseInsensitive = false; }
	void CaseInsensitive(void) { m_IsCaseInsensitive = true; }

	/** Reads the contents of the specified ini file
	If the file doesn't exist and a_AllowExampleRedirect is true, tries to read <basename>.example.ini, and
	writes its contents as <basename>.ini, if successful.
	Returns true if successful, false otherwise.
	*/
	bool ReadFile(const AString & a_FileName, bool a_AllowExampleRedirect = true);

	/// Writes data stored in class to the specified ini file
	bool WriteFile(const AString & a_FileName) const;

	/// Deletes all stored ini data (but doesn't touch the file)
	void Clear(void);

	/// Returns index of specified key, or noID if not found
	int FindKey(const AString & keyname) const;

	/// Returns index of specified value, in the specified key, or noID if not found
	int FindValue(const int keyID, const AString & valuename) const;

	/// Returns number of keys currently in the ini
	int GetNumKeys(void) const { return (int)keys.size(); }

	/// Add a key name
	int AddKeyName(const AString & keyname);

	// Returns key names by index.
	AString GetKeyName(const int keyID) const;

	// Returns number of values stored for specified key.
	int GetNumValues(const AString & keyname) const;
	int GetNumValues(const int keyID) const;

	// Returns value name by index for a given keyname or keyID.
	AString GetValueName(const AString & keyname, const int valueID) const;
	AString GetValueName(const int keyID, const int valueID) const;

	// Gets value of [keyname] valuename =.
	// Overloaded to return string, int, and double.
	// Returns defValue if key/value not found.
	AString GetValue (const AString & keyname, const AString & valuename, const AString & defValue = "")    const;
	AString GetValue (const int keyID,    const int valueID,    const AString & defValue = "")    const;
	double  GetValueF(const AString & keyname, const AString & valuename, const double    defValue = 0)     const;
	int     GetValueI(const AString & keyname, const AString & valuename, const int       defValue = 0)     const;
	bool    GetValueB(const AString & keyname, const AString & valuename, const bool      defValue = false) const
	{
		return (GetValueI(keyname, valuename, defValue ? 1 : 0) != 0);
	}
	
	// Gets the value; if not found, write the default to the INI file
	AString GetValueSet (const AString & keyname, const AString & valuename, const AString & defValue = "");
	double  GetValueSetF(const AString & keyname, const AString & valuename, const double    defValue = 0.0);
	int     GetValueSetI(const AString & keyname, const AString & valuename, const int       defValue = 0);
	bool    GetValueSetB(const AString & keyname, const AString & valuename, const bool      defValue = false)
	{
		return (GetValueSetI(keyname, valuename, defValue ? 1 : 0) != 0);
	}

	// Sets value of [keyname] valuename =.
	// Specify the optional paramter as false (0) if you do not want it to create
	// the key if it doesn't exist. Returns true if data entered, false otherwise.
	// Overloaded to accept string, int, and double.
	bool SetValue( const int keyID, const int valueID, const AString & value);
	bool SetValue( const AString & keyname, const AString & valuename, const AString & value, const bool create = true);
	bool SetValueI( const AString & keyname, const AString & valuename, const int value, const bool create = true);
	bool SetValueB( const AString & keyname, const AString & valuename, const bool value, const bool create = true)
	{
		return SetValueI( keyname, valuename, int(value), create);
	}
	bool SetValueF( const AString & keyname, const AString & valuename, const double value, const bool create = true);
	
	// tolua_end
	
	bool SetValueV( const AString & keyname, const AString & valuename, char *format, ...);
	
	// tolua_begin

	// Deletes specified value.
	// Returns true if value existed and deleted, false otherwise.
	bool DeleteValueByID(const int keyID, const int valueID);
	bool DeleteValue(const AString & keyname, const AString & valuename);

	// Deletes specified key and all values contained within.
	// Returns true if key existed and deleted, false otherwise.
	bool DeleteKey(const AString & keyname);

	// Header comment functions.
	// Header comments are those comments before the first key.

	/// Get number of header comments
	int GetNumHeaderComments(void) {return (int)comments.size();}
	
	/// Add a header comment
	void AddHeaderComment(const AString & comment);
	
	/// Return a header comment
	AString GetHeaderComment(const int commentID) const;
	
	/// Delete a header comment.
	bool DeleteHeaderComment(int commentID);
	
	/// Delete all header comments.
	void DeleteHeaderComments(void) {comments.clear();}


	// Key comment functions.
	// Key comments are those comments within a key. Any comments
	// defined within value names will be added to this list. Therefore,
	// these comments will be moved to the top of the key definition when
	// the CIniFile::WriteFile() is called.

	/// Get number of key comments
	int GetNumKeyComments(const int keyID) const;

	/// Get number of key comments
	int GetNumKeyComments(const AString & keyname) const;
	
	/// Add a key comment
	bool AddKeyComment(const int keyID, const AString & comment);

	/// Add a key comment
	bool AddKeyComment(const AString & keyname, const AString & comment);
	
	/// Return a key comment
	AString GetKeyComment(const int keyID, const int commentID) const;
	AString GetKeyComment(const AString & keyname, const int commentID) const;
	
	// Delete a key comment.
	bool DeleteKeyComment(const int keyID, const int commentID);
	bool DeleteKeyComment(const AString & keyname, const int commentID);
	
	// Delete all comments for a key.
	bool DeleteKeyComments(const int keyID);
	bool DeleteKeyComments(const AString & keyname);
};

// tolua_end

#endif