2012-06-14 09:06:06 -04:00
|
|
|
// 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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2013-08-05 09:24:23 -04:00
|
|
|
// tolua_begin
|
|
|
|
|
|
|
|
class cIniFile
|
|
|
|
{
|
2012-06-14 09:06:06 -04:00
|
|
|
private:
|
2013-08-05 09:24:23 -04:00
|
|
|
bool m_IsCaseInsensitive;
|
|
|
|
|
|
|
|
struct key
|
|
|
|
{
|
2012-06-14 09:06:06 -04:00
|
|
|
std::vector<std::string> names;
|
|
|
|
std::vector<std::string> values;
|
|
|
|
std::vector<std::string> comments;
|
2013-08-05 09:24:23 -04:00
|
|
|
} ;
|
|
|
|
|
|
|
|
std::vector<key> keys;
|
|
|
|
std::vector<std::string> names;
|
2012-06-14 09:06:06 -04:00
|
|
|
std::vector<std::string> comments;
|
2013-08-05 09:24:23 -04:00
|
|
|
|
|
|
|
/// If the object is case-insensitive, returns s as lowercase; otherwise returns s as-is
|
|
|
|
std::string CheckCase(const std::string & s) const;
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
public:
|
2013-08-05 09:24:23 -04:00
|
|
|
enum errors
|
|
|
|
{
|
|
|
|
noID = -1,
|
|
|
|
};
|
|
|
|
|
2013-10-25 05:15:44 -04:00
|
|
|
/// Creates a new instance with no data
|
|
|
|
cIniFile(void);
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
// Sets whether or not keynames and valuenames should be case sensitive.
|
|
|
|
// The default is case insensitive.
|
2013-08-05 09:24:23 -04:00
|
|
|
void CaseSensitive (void) { m_IsCaseInsensitive = false; }
|
|
|
|
void CaseInsensitive(void) { m_IsCaseInsensitive = true; }
|
2012-06-14 09:06:06 -04:00
|
|
|
|
2013-10-25 05:15:44 -04:00
|
|
|
/** Reads the contents of the specified ini file
|
2013-08-05 09:24:23 -04:00
|
|
|
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.
|
|
|
|
*/
|
2013-10-25 05:15:44 -04:00
|
|
|
bool ReadFile(const AString & a_FileName, bool a_AllowExampleRedirect = true);
|
2012-06-14 09:06:06 -04:00
|
|
|
|
2013-10-25 05:15:44 -04:00
|
|
|
/// Writes data stored in class to the specified ini file
|
|
|
|
bool WriteFile(const AString & a_FileName) const;
|
2012-06-14 09:06:06 -04:00
|
|
|
|
2013-08-05 09:24:23 -04:00
|
|
|
/// Deletes all stored ini data (but doesn't touch the file)
|
|
|
|
void Clear(void);
|
|
|
|
void Reset(void) { Clear(); }
|
|
|
|
void Erase(void) { Clear(); } // OBSOLETE, this name is misguiding and will be removed from the interface
|
2012-06-14 09:06:06 -04:00
|
|
|
|
2013-08-05 09:24:23 -04:00
|
|
|
/// Returns index of specified key, or noID if not found
|
|
|
|
long FindKey(const std::string & keyname) const;
|
2012-06-14 09:06:06 -04:00
|
|
|
|
2013-08-05 09:24:23 -04:00
|
|
|
/// Returns index of specified value, in the specified key, or noID if not found
|
|
|
|
long FindValue(const unsigned keyID, const std::string & valuename) const;
|
2012-06-14 09:06:06 -04:00
|
|
|
|
2013-08-05 09:24:23 -04:00
|
|
|
/// Returns number of keys currently in the ini
|
|
|
|
unsigned NumKeys (void) const {return names.size();}
|
|
|
|
unsigned GetNumKeys(void) const {return NumKeys();}
|
2012-06-14 09:06:06 -04:00
|
|
|
|
2013-08-05 09:24:23 -04:00
|
|
|
/// Add a key name
|
|
|
|
unsigned AddKeyName(const std::string & keyname);
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
// Returns key names by index.
|
2013-08-05 09:24:23 -04:00
|
|
|
std::string KeyName(const unsigned keyID) const;
|
|
|
|
std::string GetKeyName(const unsigned keyID) const {return KeyName(keyID);}
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
// Returns number of values stored for specified key.
|
2013-08-05 09:24:23 -04:00
|
|
|
unsigned NumValues (const std::string & keyname);
|
|
|
|
unsigned GetNumValues(const std::string & keyname) {return NumValues(keyname);}
|
|
|
|
unsigned NumValues (const unsigned keyID);
|
|
|
|
unsigned GetNumValues(const unsigned keyID) {return NumValues(keyID);}
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
// Returns value name by index for a given keyname or keyID.
|
2013-08-05 09:24:23 -04:00
|
|
|
std::string ValueName( const std::string & keyname, const unsigned valueID) const;
|
|
|
|
std::string GetValueName( const std::string & keyname, const unsigned valueID) const
|
|
|
|
{
|
|
|
|
return ValueName(keyname, valueID);
|
|
|
|
}
|
|
|
|
std::string ValueName (const unsigned keyID, const unsigned valueID) const;
|
|
|
|
std::string GetValueName(const unsigned keyID, const unsigned valueID) const
|
|
|
|
{
|
|
|
|
return ValueName(keyID, valueID);
|
|
|
|
}
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
// Gets value of [keyname] valuename =.
|
|
|
|
// Overloaded to return string, int, and double.
|
|
|
|
// Returns defValue if key/value not found.
|
2013-08-05 09:24:23 -04:00
|
|
|
AString GetValue (const AString & keyname, const AString & valuename, const AString & defValue = "") const;
|
|
|
|
AString GetValue (const unsigned keyID, const unsigned 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, int(defValue)) > 0);
|
|
|
|
}
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
// Gets the value; if not found, write the default to the INI file
|
2013-08-05 09:24:23 -04:00
|
|
|
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)
|
|
|
|
{
|
2012-06-14 09:06:06 -04:00
|
|
|
return (GetValueSetI(keyname, valuename, defValue ? 1 : 0) > 0);
|
2013-08-05 09:24:23 -04:00
|
|
|
}
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
// 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.
|
2013-08-05 09:24:23 -04:00
|
|
|
bool SetValue( const unsigned keyID, const unsigned valueID, const std::string & value);
|
|
|
|
bool SetValue( const std::string & keyname, const std::string & valuename, const std::string & value, const bool create = true);
|
|
|
|
bool SetValueI( const std::string & keyname, const std::string & valuename, const int value, const bool create = true);
|
|
|
|
bool SetValueB( const std::string & keyname, const std::string & valuename, const bool value, const bool create = true)
|
|
|
|
{
|
2012-06-14 09:06:06 -04:00
|
|
|
return SetValueI( keyname, valuename, int(value), create);
|
2013-08-05 09:24:23 -04:00
|
|
|
}
|
|
|
|
bool SetValueF( const std::string & keyname, const std::string & valuename, const double value, const bool create = true);
|
2013-08-07 08:32:08 -04:00
|
|
|
|
|
|
|
// tolua_end
|
|
|
|
|
2012-06-14 09:06:06 -04:00
|
|
|
bool SetValueV( const std::string & keyname, const std::string & valuename, char *format, ...);
|
2013-08-07 08:32:08 -04:00
|
|
|
|
|
|
|
// tolua_begin
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
// Deletes specified value.
|
|
|
|
// Returns true if value existed and deleted, false otherwise.
|
2013-08-05 09:24:23 -04:00
|
|
|
bool DeleteValueByID( const unsigned keyID, const unsigned valueID );
|
|
|
|
bool DeleteValue( const std::string & keyname, const std::string & valuename);
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
// Deletes specified key and all values contained within.
|
|
|
|
// Returns true if key existed and deleted, false otherwise.
|
2013-08-05 09:24:23 -04:00
|
|
|
bool DeleteKey(const std::string & keyname);
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
// Header comment functions.
|
|
|
|
// Header comments are those comments before the first key.
|
|
|
|
//
|
|
|
|
// Number of header comments.
|
2013-08-05 09:24:23 -04:00
|
|
|
unsigned NumHeaderComments(void) {return comments.size();}
|
2012-06-14 09:06:06 -04:00
|
|
|
// Add a header comment.
|
2013-08-05 09:24:23 -04:00
|
|
|
void HeaderComment(const std::string & comment);
|
2012-06-14 09:06:06 -04:00
|
|
|
// Return a header comment.
|
2013-08-05 09:24:23 -04:00
|
|
|
std::string HeaderComment(const unsigned commentID) const;
|
2012-06-14 09:06:06 -04:00
|
|
|
// Delete a header comment.
|
2013-08-05 09:24:23 -04:00
|
|
|
bool DeleteHeaderComment(unsigned commentID);
|
2012-06-14 09:06:06 -04:00
|
|
|
// Delete all header comments.
|
2013-08-05 09:24:23 -04:00
|
|
|
void DeleteHeaderComments(void) {comments.clear();}
|
|
|
|
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
// 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.
|
|
|
|
//
|
|
|
|
// Number of key comments.
|
2013-08-05 09:24:23 -04:00
|
|
|
unsigned NumKeyComments( const unsigned keyID) const;
|
|
|
|
unsigned NumKeyComments( const std::string & keyname) const;
|
|
|
|
|
2012-06-14 09:06:06 -04:00
|
|
|
// Add a key comment.
|
2013-08-05 09:24:23 -04:00
|
|
|
bool KeyComment(const unsigned keyID, const std::string & comment);
|
|
|
|
bool KeyComment(const std::string & keyname, const std::string & comment);
|
|
|
|
|
2012-06-14 09:06:06 -04:00
|
|
|
// Return a key comment.
|
2013-08-05 09:24:23 -04:00
|
|
|
std::string KeyComment(const unsigned keyID, const unsigned commentID) const;
|
|
|
|
std::string KeyComment(const std::string & keyname, const unsigned commentID) const;
|
|
|
|
|
2012-06-14 09:06:06 -04:00
|
|
|
// Delete a key comment.
|
2013-08-05 09:24:23 -04:00
|
|
|
bool DeleteKeyComment(const unsigned keyID, const unsigned commentID);
|
|
|
|
bool DeleteKeyComment(const std::string & keyname, const unsigned commentID);
|
|
|
|
|
2012-06-14 09:06:06 -04:00
|
|
|
// Delete all comments for a key.
|
2013-08-05 09:24:23 -04:00
|
|
|
bool DeleteKeyComments(const unsigned keyID);
|
|
|
|
bool DeleteKeyComments(const std::string & keyname);
|
|
|
|
};
|
|
|
|
|
|
|
|
// tolua_end
|
2012-06-14 09:06:06 -04:00
|
|
|
|
|
|
|
#endif
|