2 files changed, 567 insertions, 365 deletions

diff --git a/iniFile/iniFile.cpp b/iniFile/iniFile.cpp
index 76f71284f..5ecbc5e06 100644
--- a/iniFile/iniFile.cpp
+++ b/iniFile/iniFile.cpp
@@ -12,17 +12,13 @@
 //////////////////////////////////////////////////////////////////////
 
 /*
-	!! MODIFIED BY FAKETRUTH !!
+!! MODIFIED BY FAKETRUTH and xoft !!
 */
 
 #include "Globals.h"  // NOTE: MSVC stupidness requires this to be the same across all modules
 
 // C++ Includes
-#include <iostream>
 #include <fstream>
-#include <sstream>
-
-using namespace std;
 
 // C Includes
 #include <ctype.h>
@@ -31,26 +27,32 @@ using namespace std;
 #include "iniFile.h"
 
 #if defined(WIN32)
-#define iniEOL endl
+	#define iniEOL endl
 #else
-#define iniEOL '\r' << endl
+	#define iniEOL '\r' << endl
 #endif
 
 #ifndef _WIN32
-#define	sscanf_s(buffer, stringbuffer, ...) (sscanf(buffer, stringbuffer, __VA_ARGS__))
+	#define sscanf_s(buffer, stringbuffer, ...) (sscanf(buffer, stringbuffer, __VA_ARGS__))
 #endif
 
+using namespace std;
+
 
 
 
 
-cIniFile::cIniFile( const string iniPath)
+cIniFile::cIniFile(const string & a_Path) :
+	m_IsCaseInsensitive(true)
 {
-  Path( iniPath);
-  caseInsensitive = true;
+	Path(a_Path);
 }
 
-bool cIniFile::ReadFile()
+
+
+
+
+bool cIniFile::ReadFile(bool a_AllowExampleRedirect)
 {
 	// Normally you would use ifstream, but the SGI CC compiler has
 	// a few bugs with ifstream. So ... fstream used.
@@ -58,12 +60,31 @@ bool cIniFile::ReadFile()
 	string   line;
 	string   keyname, valuename, value;
 	string::size_type pLeft, pRight;
+	bool IsFromExampleRedirect = false;
+	
+	f.open((FILE_IO_PREFIX + m_Path).c_str(), ios::in);
+	if (f.fail())
+	{
+		f.clear();
+		if (a_AllowExampleRedirect)
+		{
+			// Retry with the .example.ini file instead of .ini:
+			string ExPath(m_Path.substr(0, m_Path.length() - 4));
+			ExPath.append(".example.ini");
+			f.open((FILE_IO_PREFIX + ExPath).c_str(), ios::in);
+			if (f.fail())
+			{
+				return false;
+			}
+			IsFromExampleRedirect = true;
+		}
+		else
+		{
+			return false;
+		}
+	}
 
-	f.open( (FILE_IO_PREFIX + path).c_str(), ios::in);
-	if ( f.fail())
-		return false;
-
-	while (getline( f, line))
+	while (getline(f, line))
 	{
 		// To be compatible with Win32, check for existence of '\r'.
 		// Win32 files have the '\r' and Unix files don't at the end of a line.
@@ -75,49 +96,49 @@ bool cIniFile::ReadFile()
 		{
 			continue;
 		}
-		if ( line[lineLength - 1] == '\r')
+		if (line[lineLength - 1] == '\r')
 		{
-			line = line.substr( 0, lineLength - 1);
+			line = line.substr(0, lineLength - 1);
 		}
 
 		if (line.length() == 0)
 		{
 			continue;
 		}
-		
+
 		// Check that the user hasn't opened a binary file by checking the first
 		// character of each line!
-		if ( !isprint( line[0]))
+		if (!isprint(line[0]))
 		{
-			printf( "Failing on char %d\n", line[0]);
+			printf("%s: Binary-check failed on char %d\n", __FUNCTION__, line[0]);
 			f.close();
 			return false;
 		}
-		if (( pLeft = line.find_first_of(";#[=")) == string::npos)
+		if ((pLeft = line.find_first_of(";#[=")) == string::npos)
 		{
 			continue;
 		}
-		
-		switch ( line[pLeft])
+
+		switch (line[pLeft])
 		{
 			case '[':
 			{
 				if (
 					((pRight = line.find_last_of("]")) != string::npos) &&
 					(pRight > pLeft)
-				)
+					)
 				{
-					keyname = line.substr( pLeft + 1, pRight - pLeft - 1);
-					AddKeyName( keyname);
+					keyname = line.substr(pLeft + 1, pRight - pLeft - 1);
+					AddKeyName(keyname);
 				}
 				break;
 			}
 
 			case '=':
 			{
-				valuename = line.substr( 0, pLeft);
-				value = line.substr( pLeft + 1);
-				SetValue( keyname, valuename, value);
+				valuename = line.substr(0, pLeft);
+				value = line.substr(pLeft + 1);
+				SetValue(keyname, valuename, value);
 				break;
 			}
 
@@ -126,11 +147,11 @@ bool cIniFile::ReadFile()
 			{
 				if (names.size() == 0)
 				{
-					HeaderComment( line.substr( pLeft + 1));
+					HeaderComment(line.substr(pLeft + 1));
 				}
 				else
 				{
-					KeyComment( keyname, line.substr( pLeft + 1));
+					KeyComment(keyname, line.substr(pLeft + 1));
 				}
 				break;
 			}
@@ -138,256 +159,315 @@ bool cIniFile::ReadFile()
 	}  // while (getline())
 
 	f.close();
-	if (names.size() > 0)
+	if (names.size() == 0)
 	{
-		return true;
+		return false;
 	}
-	return false;
+	
+	if (IsFromExampleRedirect)
+	{
+		WriteFile();
+	}
+	return true;
 }
 
 
 
 
 
-bool cIniFile::WriteFile()
+bool cIniFile::WriteFile(void) const
 {
-  unsigned commentID, keyID, valueID;
-  // Normally you would use ofstream, but the SGI CC compiler has
-  // a few bugs with ofstream. So ... fstream used.
-  fstream f;
+	unsigned commentID, keyID, valueID;
+	// Normally you would use ofstream, but the SGI CC compiler has
+	// a few bugs with ofstream. So ... fstream used.
+	fstream f;
 
-  f.open( (FILE_IO_PREFIX + path).c_str(), ios::out);
-  if ( f.fail())
-    return false;
+	f.open((FILE_IO_PREFIX + m_Path).c_str(), ios::out);
+	if (f.fail())
+	{
+		return false;
+	}
 
-  // Write header comments.
-  for ( commentID = 0; commentID < comments.size(); ++commentID)
-    f << ';' << comments[commentID] << iniEOL;
-  if ( comments.size())
-    f << iniEOL;
+	// Write header comments.
+	for (commentID = 0; commentID < comments.size(); ++commentID)
+	{
+		f << ';' << comments[commentID] << iniEOL;
+	}
+	if (comments.size())
+	{
+		f << iniEOL;
+	}
 
-  // Write keys and values.
-  for ( keyID = 0; keyID < keys.size(); ++keyID) {
-    f << '[' << names[keyID] << ']' << iniEOL;
-    // Comments.
-    for ( commentID = 0; commentID < keys[keyID].comments.size(); ++commentID)
-      f << ';' << keys[keyID].comments[commentID] << iniEOL;
-    // Values.
-    for ( valueID = 0; valueID < keys[keyID].names.size(); ++valueID)
-      f << keys[keyID].names[valueID] << '=' << keys[keyID].values[valueID] << iniEOL;
-    f << iniEOL;
-  }
-  f.close();
+	// Write keys and values.
+	for (keyID = 0; keyID < keys.size(); ++keyID)
+	{
+		f << '[' << names[keyID] << ']' << iniEOL;
+		
+		// Comments.
+		for (commentID = 0; commentID < keys[keyID].comments.size(); ++commentID)
+		{
+			f << ';' << keys[keyID].comments[commentID] << iniEOL;
+		}
+		
+		// Values.
+		for (valueID = 0; valueID < keys[keyID].names.size(); ++valueID)
+		{
+			f << keys[keyID].names[valueID] << '=' << keys[keyID].values[valueID] << iniEOL;
+		}
+		f << iniEOL;
+	}
+	f.close();
 
-  return true;
+	return true;
 }
 
 
 
 
 
-long cIniFile::FindKey( const string & keyname) const
+long cIniFile::FindKey(const string & a_KeyName) const
 {
-  for ( unsigned keyID = 0; keyID < names.size(); ++keyID)
-    if ( CheckCase( names[keyID]) == CheckCase( keyname))
-      return long(keyID);
-  return noID;
+	string CaseKeyName = CheckCase(a_KeyName);
+	for (unsigned keyID = 0; keyID < names.size(); ++keyID)
+	{
+		if (CheckCase(names[keyID]) == CaseKeyName)
+		{
+			return long(keyID);
+		}
+	}
+	return noID;
 }
 
 
 
 
 
-long cIniFile::FindValue( unsigned const keyID, const string & valuename) const
+long cIniFile::FindValue(unsigned const keyID, const string & a_ValueName) const
 {
-  if ( !keys.size() || keyID >= keys.size())
-    return noID;
+	if (!keys.size() || (keyID >= keys.size()))
+	{
+		return noID;
+	}
 
-  for ( unsigned valueID = 0; valueID < keys[keyID].names.size(); ++valueID)
-    if ( CheckCase( keys[keyID].names[valueID]) == CheckCase( valuename))
-      return long(valueID);
-  return noID;
+	string CaseValueName = CheckCase(a_ValueName);
+	for (unsigned valueID = 0; valueID < keys[keyID].names.size(); ++valueID)
+	{
+		if (CheckCase(keys[keyID].names[valueID]) == CaseValueName)
+		{
+			return long(valueID);
+		}
+	}
+	return noID;
 }
 
 
 
 
 
-unsigned cIniFile::AddKeyName( const string & keyname)
+unsigned cIniFile::AddKeyName(const string & keyname)
 {
-  names.resize( names.size() + 1, keyname);
-  keys.resize( keys.size() + 1);
-  return names.size() - 1;
+	names.resize(names.size() + 1, keyname);
+	keys.resize(keys.size() + 1);
+	return names.size() - 1;
 }
 
 
 
 
 
-string cIniFile::KeyName( unsigned const keyID) const
+string cIniFile::KeyName(unsigned const keyID) const
 {
-  if ( keyID < names.size())
-    return names[keyID];
-  else
-    return "";
+	if (keyID < names.size())
+	{
+		return names[keyID];
+	}
+	else
+	{
+		return "";
+	}
 }
 
 
 
 
 
-unsigned cIniFile::NumValues( unsigned const keyID)
+unsigned cIniFile::NumValues(unsigned const keyID)
 {
-  if ( keyID < keys.size())
-    return keys[keyID].names.size();
-  return 0;
+	if (keyID < keys.size())
+	{
+		return keys[keyID].names.size();
+	}
+	return 0;
 }
 
 
 
 
 
-unsigned cIniFile::NumValues( const string & keyname)
+unsigned cIniFile::NumValues(const string & keyname)
 {
-  long keyID = FindKey( keyname);
-  if ( keyID == noID)
-    return 0;
-  return keys[keyID].names.size();
+	long keyID = FindKey(keyname);
+	if (keyID == noID)
+	{
+		return 0;
+	}
+	return keys[keyID].names.size();
 }
 
 
 
 
 
-string cIniFile::ValueName( unsigned const keyID, unsigned const valueID) const
+string cIniFile::ValueName(unsigned const keyID, unsigned const valueID) const
 {
-  if ( keyID < keys.size() && valueID < keys[keyID].names.size())
-    return keys[keyID].names[valueID];
-  return "";
+	if (keyID < keys.size() && valueID < keys[keyID].names.size())
+	{
+		return keys[keyID].names[valueID];
+	}
+	return "";
 }
 
 
 
 
 
-string cIniFile::ValueName( const string & keyname, unsigned const valueID) const
+string cIniFile::ValueName(const string & keyname, unsigned const valueID) const
 {
-  long keyID = FindKey( keyname);
-  if ( keyID == noID)
-    return "";
-  return ValueName( keyID, valueID);
+	long keyID = FindKey(keyname);
+	if (keyID == noID)
+	{
+		return "";
+	}
+	return ValueName(keyID, valueID);
 }
 
 
 
 
 
-bool cIniFile::SetValue( unsigned const keyID, unsigned const valueID, const string & value)
+bool cIniFile::SetValue(unsigned const keyID, unsigned const valueID, const string & value)
 {
-  if ( keyID < keys.size() && valueID < keys[keyID].names.size())
-    keys[keyID].values[valueID] = value;
-
-  return false;
+	if ((keyID < keys.size()) && (valueID < keys[keyID].names.size()))
+	{
+		keys[keyID].values[valueID] = value;
+	}
+	return false;
 }
 
 
 
 
 
-bool cIniFile::SetValue( const string & keyname, const string & valuename, const string & value, bool const create)
+bool cIniFile::SetValue(const string & keyname, const string & valuename, const string & value, bool const create)
 {
-  long keyID = FindKey( keyname);
-  if ( keyID == noID) {
-    if ( create)
-      keyID = long( AddKeyName( keyname));
-    else
-      return false;
-  }
+	long keyID = FindKey(keyname);
+	if (keyID == noID)
+	{
+		if (create)
+		{
+			keyID = long(AddKeyName(keyname));
+		}
+		else
+		{
+			return false;
+		}
+	}
 
-  long valueID = FindValue( unsigned(keyID), valuename);
-  if ( valueID == noID) {
-    if ( !create)
-      return false;
-    keys[keyID].names.resize( keys[keyID].names.size() + 1, valuename);
-    keys[keyID].values.resize( keys[keyID].values.size() + 1, value);
-  } else
-  {
-	  if(!create)
-		keys[keyID].values[valueID] = value;
-	  else
-	  {
-		  keys[keyID].names.resize( keys[keyID].names.size() + 1, valuename);
-		  keys[keyID].values.resize( keys[keyID].values.size() + 1, value);
-	  }
-  }
+	long valueID = FindValue(unsigned(keyID), valuename);
+	if (valueID == noID)
+	{
+		if (!create)
+		{
+			return false;
+		}
+		keys[keyID].names.resize(keys[keyID].names.size() + 1, valuename);
+		keys[keyID].values.resize(keys[keyID].values.size() + 1, value);
+	}
+	else
+	{
+		if (!create)
+		{
+			keys[keyID].values[valueID] = value;
+		}
+		else
+		{
+			keys[keyID].names.resize(keys[keyID].names.size() + 1, valuename);
+			keys[keyID].values.resize(keys[keyID].values.size() + 1, value);
+		}
+	}
 
-  return true;
+	return true;
 }
 
 
 
 
 
-bool cIniFile::SetValueI( const string & keyname, const string & valuename, int const value, bool const create)
+bool cIniFile::SetValueI(const string & keyname, const string & valuename, int const value, bool const create)
 {
-  AString Data;
-  Printf(Data, "%d", value);
-  return SetValue( keyname, valuename, Data, create);
+	AString Data;
+	Printf(Data, "%d", value);
+	return SetValue(keyname, valuename, Data, create);
 }
 
 
 
 
 
-bool cIniFile::SetValueF( const string & keyname, const string & valuename, double const value, bool const create)
+bool cIniFile::SetValueF(const string & keyname, const string & valuename, double const value, bool const create)
 {
-  AString Data;
-  Printf(Data, "%f", value);
-  return SetValue( keyname, valuename, Data, create);
+	AString Data;
+	Printf(Data, "%f", value);
+	return SetValue(keyname, valuename, Data, create);
 }
 
 
 
 
 
-bool cIniFile::SetValueV( const string & keyname, const string & valuename, char *format, ...)
+bool cIniFile::SetValueV(const string & keyname, const string & valuename, char * format, ...)
 {
-  va_list args;
+	va_list args;
+	va_start(args, format);
 
-  va_start( args, format);
-  
-  AString Data;
-  AppendVPrintf(Data, format, args);
-  va_end( args);
-  return SetValue( keyname, valuename, Data);
+	AString Data;
+	AppendVPrintf(Data, format, args);
+	va_end(args);
+	return SetValue(keyname, valuename, Data);
 }
 
 
 
 
 
-string cIniFile::GetValue( unsigned const keyID, unsigned const valueID, const string & defValue) const
+string cIniFile::GetValue(unsigned const keyID, unsigned const valueID, const string & defValue) const
 {
-  if ( keyID < keys.size() && valueID < keys[keyID].names.size())
-    return keys[keyID].values[valueID];
-  return defValue;
+	if ((keyID < keys.size()) && (valueID < keys[keyID].names.size()))
+	{
+		return keys[keyID].values[valueID];
+	}
+	return defValue;
 }
 
 
 
 
 
-string cIniFile::GetValue( const string & keyname, const string & valuename, const string & defValue) const
+string cIniFile::GetValue(const string & keyname, const string & valuename, const string & defValue) const
 {
-  long keyID = FindKey( keyname);
-  if ( keyID == noID)
-    return defValue;
+	long keyID = FindKey(keyname);
+	if (keyID == noID)
+	{
+		return defValue;
+	}
 
-  long valueID = FindValue( unsigned(keyID), valuename);
-  if ( valueID == noID)
-    return defValue;
+	long valueID = FindValue(unsigned(keyID), valuename);
+	if (valueID == noID)
+	{
+		return defValue;
+	}
 
-  return keys[keyID].values[valueID];
+	return keys[keyID].values[valueID];
 }
 
 
@@ -398,7 +478,7 @@ int cIniFile::GetValueI(const string & keyname, const string & valuename, int co
 {
 	AString Data;
 	Printf(Data, "%d", defValue);
-  return atoi( GetValue( keyname, valuename, Data).c_str());
+	return atoi(GetValue(keyname, valuename, Data).c_str());
 }
 
 
@@ -407,9 +487,9 @@ int cIniFile::GetValueI(const string & keyname, const string & valuename, int co
 
 double cIniFile::GetValueF(const string & keyname, const string & valuename, double const defValue) const
 {
-  AString Data;
-  Printf(Data, "%f", defValue);
-  return atof( GetValue( keyname, valuename, Data).c_str());
+	AString Data;
+	Printf(Data, "%f", defValue);
+	return atof(GetValue(keyname, valuename, Data).c_str());
 }
 
 
@@ -418,15 +498,15 @@ double cIniFile::GetValueF(const string & keyname, const string & valuename, dou
 
 AString cIniFile::GetValueSet(const AString & keyname, const AString & valuename, const AString & defValue)
 {
-	long keyID = FindKey( keyname);
-	if ( keyID == noID)
+	long keyID = FindKey(keyname);
+	if (keyID == noID)
 	{
 		SetValue(keyname, valuename, defValue);
 		return defValue;
 	}
 
-	long valueID = FindValue( unsigned(keyID), valuename);
-	if ( valueID == noID)
+	long valueID = FindValue(unsigned(keyID), valuename);
+	if (valueID == noID)
 	{
 		SetValue(keyname, valuename, defValue);
 		return defValue;
@@ -441,9 +521,9 @@ AString cIniFile::GetValueSet(const AString & keyname, const AString & valuename
 
 double cIniFile::GetValueSetF(const AString & keyname, const AString & valuename, const double defValue)
 {
-  AString Data;
-  Printf(Data, "%f", defValue);
-  return atof(GetValueSet(keyname, valuename, Data).c_str());
+	AString Data;
+	Printf(Data, "%f", defValue);
+	return atof(GetValueSet(keyname, valuename, Data).c_str());
 }
 
 
@@ -454,182 +534,273 @@ int cIniFile::GetValueSetI(const AString & keyname, const AString & valuename, c
 {
 	AString Data;
 	Printf(Data, "%d", defValue);
-  return atoi(GetValueSet(keyname, valuename, Data).c_str());
+	return atoi(GetValueSet(keyname, valuename, Data).c_str());
 }
 
 
 
 
 
-bool cIniFile::DeleteValueByID( const unsigned keyID, const unsigned valueID )
+bool cIniFile::DeleteValueByID(const unsigned keyID, const unsigned valueID)
 {
-	if ( keyID < keys.size() && valueID < keys[keyID].names.size())
+	if (keyID < keys.size() && valueID < keys[keyID].names.size())
 	{
 		// This looks strange, but is neccessary.
 		vector<string>::iterator npos = keys[keyID].names.begin() + valueID;
 		vector<string>::iterator vpos = keys[keyID].values.begin() + valueID;
-		keys[keyID].names.erase( npos, npos + 1);
-		keys[keyID].values.erase( vpos, vpos + 1);
+		keys[keyID].names.erase(npos, npos + 1);
+		keys[keyID].values.erase(vpos, vpos + 1);
 		return true;
 	}
 	return false;
 }
 
-bool cIniFile::DeleteValue( const string & keyname, const string & valuename)
+
+
+
+
+bool cIniFile::DeleteValue(const string & keyname, const string & valuename)
 {
-  long keyID = FindKey( keyname);
-  if ( keyID == noID)
-    return false;
+	long keyID = FindKey(keyname);
+	if (keyID == noID)
+	{
+		return false;
+	}
 
-  long valueID = FindValue( unsigned(keyID), valuename);
-  if ( valueID == noID)
-    return false;
+	long valueID = FindValue(unsigned(keyID), valuename);
+	if (valueID == noID)
+	{
+		return false;
+	}
 
-  return DeleteValueByID( keyID, valueID );
+	return DeleteValueByID(keyID, valueID);
 }
 
-bool cIniFile::DeleteKey( const string & keyname)
-{
-  long keyID = FindKey( keyname);
-  if ( keyID == noID)
-    return false;
 
-  // Now hopefully this destroys the vector lists within keys.
-  // Looking at <vector> source, this should be the case using the destructor.
-  // If not, I may have to do it explicitly. Memory leak check should tell.
-  // memleak_test.cpp shows that the following not required.
-  //keys[keyID].names.clear();
-  //keys[keyID].values.clear();
 
-  vector<string>::iterator npos = names.begin() + keyID;
-  vector<key>::iterator    kpos = keys.begin() + keyID;
-  names.erase( npos, npos + 1);
-  keys.erase( kpos, kpos + 1);
 
-  return true;
+
+bool cIniFile::DeleteKey(const string & keyname)
+{
+	long keyID = FindKey(keyname);
+	if (keyID == noID)
+	{
+		return false;
+	}
+
+	vector<string>::iterator npos = names.begin() + keyID;
+	vector<key>::iterator    kpos = keys.begin() + keyID;
+	names.erase(npos, npos + 1);
+	keys.erase(kpos, kpos + 1);
+
+	return true;
 }
 
-void cIniFile::Erase()
+
+
+
+
+void cIniFile::Clear(void)
 {
-  // This loop not needed. The vector<> destructor seems to do
-  // all the work itself. memleak_test.cpp shows this.
-  //for ( unsigned i = 0; i < keys.size(); ++i) {
-  //  keys[i].names.clear();
-  //  keys[i].values.clear();
-  //}
-  names.clear();
-  keys.clear();
-  comments.clear();
+	names.clear();
+	keys.clear();
+	comments.clear();
 }
 
-void cIniFile::HeaderComment( const string & comment)
+
+
+
+
+void cIniFile::HeaderComment(const string & comment)
 {
-  comments.resize( comments.size() + 1, comment);
+	comments.push_back(comment);
+	// comments.resize(comments.size() + 1, comment);
 }
 
-string cIniFile::HeaderComment( unsigned const commentID) const
+
+
+
+
+string cIniFile::HeaderComment(unsigned const commentID) const
 {
-  if ( commentID < comments.size())
-    return comments[commentID];
-  return "";
+	if (commentID < comments.size())
+	{
+		return comments[commentID];
+	}
+	return "";
 }
 
-bool cIniFile::DeleteHeaderComment( unsigned commentID)
+
+
+
+
+bool cIniFile::DeleteHeaderComment(unsigned commentID)
 {
-  if ( commentID < comments.size()) {
-    vector<string>::iterator cpos = comments.begin() + commentID;
-    comments.erase( cpos, cpos + 1);
-    return true;
-  }
-  return false;
+	if (commentID < comments.size())
+	{
+		vector<string>::iterator cpos = comments.begin() + commentID;
+		comments.erase(cpos, cpos + 1);
+		return true;
+	}
+	return false;
 }
 
-unsigned cIniFile::NumKeyComments( unsigned const keyID) const
+
+
+
+
+unsigned cIniFile::NumKeyComments(unsigned const keyID) const
 {
-  if ( keyID < keys.size())
-    return keys[keyID].comments.size();
-  return 0;
+	if (keyID < keys.size())
+	{
+		return keys[keyID].comments.size();
+	}
+	return 0;
 }
 
-unsigned cIniFile::NumKeyComments( const string & keyname) const
+
+
+
+
+unsigned cIniFile::NumKeyComments(const string & keyname) const
 {
-  long keyID = FindKey( keyname);
-  if ( keyID == noID)
-    return 0;
-  return keys[keyID].comments.size();
+	long keyID = FindKey(keyname);
+	if (keyID == noID)
+		return 0;
+	return keys[keyID].comments.size();
 }
 
-bool cIniFile::KeyComment( unsigned const keyID, const string & comment)
+
+
+
+
+bool cIniFile::KeyComment(unsigned const keyID, const string & comment)
 {
-  if ( keyID < keys.size()) {
-    keys[keyID].comments.resize( keys[keyID].comments.size() + 1, comment);
-    return true;
-  }
-  return false;
+	if (keyID < keys.size())
+	{
+		keys[keyID].comments.resize(keys[keyID].comments.size() + 1, comment);
+		return true;
+	}
+	return false;
 }
 
-bool cIniFile::KeyComment( const string & keyname, const string & comment)
+
+
+
+
+bool cIniFile::KeyComment(const string & keyname, const string & comment)
 {
-  long keyID = FindKey( keyname);
-  if ( keyID == noID)
-    return false;
-  return KeyComment( unsigned(keyID), comment);
+	long keyID = FindKey(keyname);
+	if (keyID == noID)
+	{
+		return false;
+	}
+	return KeyComment(unsigned(keyID), comment);
 }
 
-string cIniFile::KeyComment( unsigned const keyID, unsigned const commentID) const
+
+
+
+
+string cIniFile::KeyComment(unsigned const keyID, unsigned const commentID) const
 {
-  if ( keyID < keys.size() && commentID < keys[keyID].comments.size())
-    return keys[keyID].comments[commentID];
-  return "";
+	if ((keyID < keys.size()) && (commentID < keys[keyID].comments.size()))
+	{
+		return keys[keyID].comments[commentID];
+	}
+	return "";
 }
 
-string cIniFile::KeyComment( const string & keyname, unsigned const commentID) const
+
+
+
+
+string cIniFile::KeyComment(const string & keyname, unsigned const commentID) const
 {
-  long keyID = FindKey( keyname);
-  if ( keyID == noID)
-    return "";
-  return KeyComment( unsigned(keyID), commentID);
+	long keyID = FindKey(keyname);
+	if (keyID == noID)
+	{
+		return "";
+	}
+	return KeyComment(unsigned(keyID), commentID);
 }
 
-bool cIniFile::DeleteKeyComment( unsigned const keyID, unsigned const commentID)
+
+
+
+
+bool cIniFile::DeleteKeyComment(unsigned const keyID, unsigned const commentID)
 {
-  if ( keyID < keys.size() && commentID < keys[keyID].comments.size()) {
-    vector<string>::iterator cpos = keys[keyID].comments.begin() + commentID;
-    keys[keyID].comments.erase( cpos, cpos + 1);
-    return true;
-  }
-  return false;
+	if ((keyID < keys.size()) && (commentID < keys[keyID].comments.size()))
+	{
+		vector<string>::iterator cpos = keys[keyID].comments.begin() + commentID;
+		keys[keyID].comments.erase(cpos, cpos + 1);
+		return true;
+	}
+	return false;
 }
 
-bool cIniFile::DeleteKeyComment( const string & keyname, unsigned const commentID)
+
+
+
+
+bool cIniFile::DeleteKeyComment(const string & keyname, unsigned const commentID)
 {
-  long keyID = FindKey( keyname);
-  if ( keyID == noID)
-    return false;
-  return DeleteKeyComment( unsigned(keyID), commentID);
+	long keyID = FindKey(keyname);
+	if (keyID == noID)
+	{
+		return false;
+	}
+	return DeleteKeyComment(unsigned(keyID), commentID);
 }
 
-bool cIniFile::DeleteKeyComments( unsigned const keyID)
+
+
+
+
+bool cIniFile::DeleteKeyComments(unsigned const keyID)
 {
-  if ( keyID < keys.size()) {
-    keys[keyID].comments.clear();
-    return true;
-  }
-  return false;
+	if (keyID < keys.size())
+	{
+		keys[keyID].comments.clear();
+		return true;
+	}
+	return false;
 }
 
-bool cIniFile::DeleteKeyComments( const string & keyname)
+
+
+
+
+bool cIniFile::DeleteKeyComments(const string & keyname)
 {
-  long keyID = FindKey( keyname);
-  if ( keyID == noID)
-    return false;
-  return DeleteKeyComments( unsigned(keyID));
+	long keyID = FindKey(keyname);
+	if (keyID == noID)
+	{
+		return false;
+	}
+	return DeleteKeyComments(unsigned(keyID));
 }
 
-string cIniFile::CheckCase( string s) const
+
+
+
+
+string cIniFile::CheckCase(const string & s) const
 {
-  if ( caseInsensitive)
-    for ( string::size_type i = 0; i < s.length(); ++i)
-      s[i] = (char)tolower(s[i]);
-  return s;
+	if (!m_IsCaseInsensitive)
+	{
+		return s;
+	}
+	string res(s);
+	size_t len = res.length();
+	for (size_t i = 0; i < len; i++)
+	{
+		res[i] = tolower(res[i]);
+	}
+	return res;
 }
+
+
+
+
diff --git a/iniFile/iniFile.h b/iniFile/iniFile.h
index 1afc404e3..aef45c094 100644
--- a/iniFile/iniFile.h
+++ b/iniFile/iniFile.h
@@ -30,135 +30,160 @@
 
 
 
-class cIniFile							// tolua_export
-{										// tolua_export
+// tolua_begin
+
+class cIniFile
+{
 private:
-	bool   caseInsensitive;
-	std::string path;
-	struct key {
+	bool        m_IsCaseInsensitive;
+	std::string m_Path;
+	
+	struct key
+	{
 		std::vector<std::string> names;
 		std::vector<std::string> values; 
 		std::vector<std::string> comments;
-	};
-	std::vector<key>    keys; 
-	std::vector<std::string> names; 
+	} ;
+	
+	std::vector<key>         keys;
+	std::vector<std::string> names;
 	std::vector<std::string> comments;
-	std::string CheckCase( std::string s) const;
+	
+	/// If the object is case-insensitive, returns s as lowercase; otherwise returns s as-is
+	std::string CheckCase(const std::string & s) const;
 
 public:
-	enum errors{ noID = -1};									// tolua_export
-	cIniFile( const std::string iniPath = "");				// tolua_export
-	virtual ~cIniFile()                            {}
+	enum errors
+	{
+		noID = -1,
+	};
+	
+	/// Creates a new instance; sets m_Path to a_Path, but doesn't read the file
+	cIniFile(const std::string & a_Path = "");
 
 	// Sets whether or not keynames and valuenames should be case sensitive.
 	// The default is case insensitive.
-	void CaseSensitive()                           {caseInsensitive = false;}	// tolua_export
-	void CaseInsensitive()                         {caseInsensitive = true;}	// tolua_export
+	void CaseSensitive  (void) { m_IsCaseInsensitive = false; }
+	void CaseInsensitive(void) { m_IsCaseInsensitive = true; }
 
 	// Sets path of ini file to read and write from.
-	void Path(const std::string & newPath)                {path = newPath;}	// tolua_export
-	std::string Path() const                            {return path;}	// tolua_export
-	void SetPath(const std::string & newPath)             {Path( newPath);}	// tolua_export
+	void Path(const std::string & newPath)    {m_Path = newPath;}
+	const std::string & Path(void) const      {return m_Path;}
+	void SetPath(const std::string & newPath) {Path(newPath);}
 
-	// Reads ini file specified using path.
-	// Returns true if successful, false otherwise.
-	bool ReadFile();														// tolua_export
+	/** Reads the ini file specified in m_Path
+	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(bool a_AllowExampleRedirect = true);
 
-	// Writes data stored in class to ini file.
-	bool WriteFile();														// tolua_export
+	/// Writes data stored in class to ini file specified in m_Path
+	bool WriteFile(void) const;
 
-	// Deletes all stored ini data.
-	void Erase();															// tolua_export
-	void Clear()                                   {Erase();}				// tolua_export
-	void Reset()                                   {Erase();}				// tolua_export
+	/// 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
 
-	// Returns index of specified key, or noID if not found.
-	long FindKey( const std::string & keyname) const;						// tolua_export
+	/// Returns index of specified key, or noID if not found
+	long FindKey(const std::string & keyname) const;
 
-	// Returns index of specified value, in the specified key, or noID if not found.
-	long FindValue( const unsigned keyID, const std::string & valuename) const;		// tolua_export
+	/// Returns index of specified value, in the specified key, or noID if not found
+	long FindValue(const unsigned keyID, const std::string & valuename) const;
 
-	// Returns number of keys currently in the ini.
-	unsigned NumKeys() const                       {return names.size();}			// tolua_export
-	unsigned GetNumKeys() const                    {return NumKeys();}			// tolua_export
+	/// Returns number of keys currently in the ini
+	unsigned NumKeys   (void) const {return names.size();}
+	unsigned GetNumKeys(void) const {return NumKeys();}
 
-	// Add a key name.
-	unsigned AddKeyName( const std::string & keyname);								// tolua_export
+	/// Add a key name
+	unsigned AddKeyName(const std::string & keyname);
 
 	// Returns key names by index.
-	std::string KeyName( const unsigned keyID) const;								// tolua_export
-	std::string GetKeyName( const unsigned keyID) const {return KeyName(keyID);}	// tolua_export
+	std::string KeyName(const unsigned keyID) const;
+	std::string GetKeyName(const unsigned keyID) const {return KeyName(keyID);}
 
 	// Returns number of values stored for specified key.
-	unsigned NumValues( const std::string & keyname);									// tolua_export
-	unsigned GetNumValues( const std::string & keyname)   {return NumValues( keyname);}	// tolua_export
-	unsigned NumValues( const unsigned keyID);										// tolua_export
-	unsigned GetNumValues( const unsigned keyID)   {return NumValues( keyID);}		// tolua_export
+	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);}
 
 	// Returns value name by index for a given keyname or keyID.
-	std::string ValueName( const std::string & keyname, const unsigned valueID) const;	// tolua_export
-	std::string GetValueName( const std::string & keyname, const unsigned valueID) const {	// tolua_export
-		return ValueName( keyname, valueID);
-	}																						// tolua_export
-	std::string ValueName( const unsigned keyID, const unsigned valueID) const;		// tolua_export
-	std::string GetValueName( const unsigned keyID, const unsigned valueID) const {	// tolua_export
-		return ValueName( keyID, valueID);
-	}																					// tolua_export
+	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);
+	}
 
 	// 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;   // tolua_export
-	AString GetValue (const unsigned keyID,    const unsigned valueID,    const AString & defValue = "")    const;   // tolua_export
-	double  GetValueF(const AString & keyname, const AString & valuename, const double    defValue = 0)     const;   // tolua_export
-	int     GetValueI(const AString & keyname, const AString & valuename, const int       defValue = 0)     const;   // tolua_export
-	bool    GetValueB(const AString & keyname, const AString & valuename, const bool      defValue = false) const {  // tolua_export
-		return ( GetValueI( keyname, valuename, int( defValue)) > 0);
-	}  // tolua_export
+	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);
+	}
 	
 	// Gets the value; if not found, write the default to the INI file
-	AString GetValueSet (const AString & keyname, const AString & valuename, const AString & defValue = "");      // tolua_export
-	double  GetValueSetF(const AString & keyname, const AString & valuename, const double    defValue = 0.0);     // tolua_export
-	int     GetValueSetI(const AString & keyname, const AString & valuename, const int       defValue = 0);       // tolua_export
-	bool    GetValueSetB(const AString & keyname, const AString & valuename, const bool      defValue = false) {  // tolua_export
+	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);
-	}  // tolua_export
+	}
 
 	// 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 unsigned keyID, const unsigned valueID, const std::string & value);											// tolua_export
-	bool SetValue( const std::string & keyname, const std::string & valuename, const std::string & value, const bool create = true);		// tolua_export
-	bool SetValueI( const std::string & keyname, const std::string & valuename, const int value, const bool create = true);				// tolua_export
-	bool SetValueB( const std::string & keyname, const std::string & valuename, const bool value, const bool create = true) {				// tolua_export
+	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)
+	{
 		return SetValueI( keyname, valuename, int(value), create);
-	}																																	// tolua_export
-	bool SetValueF( const std::string & keyname, const std::string & valuename, const double value, const bool create = true);			// tolua_export
+	}
+	bool SetValueF( const std::string & keyname, const std::string & valuename, const double value, const bool create = true);
+	
+	// tolua_end
+	
 	bool SetValueV( const std::string & keyname, const std::string & valuename, char *format, ...);
+	
+	// tolua_begin
 
 	// Deletes specified value.
 	// Returns true if value existed and deleted, false otherwise.
-	bool DeleteValueByID( const unsigned keyID, const unsigned valueID );																	// tolua_export
-	bool DeleteValue( const std::string & keyname, const std::string & valuename);														// tolua_export
+	bool DeleteValueByID( const unsigned keyID, const unsigned valueID );
+	bool DeleteValue( const std::string & keyname, const std::string & valuename);
 
 	// Deletes specified key and all values contained within.
 	// Returns true if key existed and deleted, false otherwise.
-	bool DeleteKey(const std::string & keyname);																								// tolua_export
+	bool DeleteKey(const std::string & keyname);
 
 	// Header comment functions.
 	// Header comments are those comments before the first key.
 	//
 	// Number of header comments.
-	unsigned NumHeaderComments()                  {return comments.size();}															// tolua_export
+	unsigned NumHeaderComments(void) {return comments.size();}
 	// Add a header comment.
-	void     HeaderComment( const std::string & comment);																				// tolua_export
+	void     HeaderComment(const std::string & comment);
 	// Return a header comment.
-	std::string   HeaderComment( const unsigned commentID) const;																		// tolua_export
+	std::string   HeaderComment(const unsigned commentID) const;
 	// Delete a header comment.
-	bool     DeleteHeaderComment( unsigned commentID);																				// tolua_export
+	bool     DeleteHeaderComment(unsigned commentID);
 	// Delete all header comments.
-	void     DeleteHeaderComments()               {comments.clear();}																	// tolua_export
+	void     DeleteHeaderComments(void) {comments.clear();}
+
 
 	// Key comment functions.
 	// Key comments are those comments within a key. Any comments
@@ -167,20 +192,26 @@ public:
 	// the CIniFile::WriteFile() is called.
 	//
 	// Number of key comments.
-	unsigned NumKeyComments( const unsigned keyID) const;																				// tolua_export
-	unsigned NumKeyComments( const std::string & keyname) const;																		// tolua_export
+	unsigned NumKeyComments( const unsigned keyID) const;
+	unsigned NumKeyComments( const std::string & keyname) const;
+	
 	// Add a key comment.
-	bool     KeyComment( const unsigned keyID, const std::string & comment);															// tolua_export
-	bool     KeyComment( const std::string & keyname, const std::string & comment);														// tolua_export
+	bool     KeyComment(const unsigned keyID, const std::string & comment);
+	bool     KeyComment(const std::string & keyname, const std::string & comment);
+	
 	// Return a key comment.
-	std::string   KeyComment( const unsigned keyID, const unsigned commentID) const;													// tolua_export
-	std::string   KeyComment( const std::string & keyname, const unsigned commentID) const;												// tolua_export
+	std::string   KeyComment(const unsigned keyID, const unsigned commentID) const;
+	std::string   KeyComment(const std::string & keyname, const unsigned commentID) const;
+	
 	// Delete a key comment.
-	bool     DeleteKeyComment( const unsigned keyID, const unsigned commentID);														// tolua_export
-	bool     DeleteKeyComment( const std::string & keyname, const unsigned commentID);													// tolua_export
+	bool     DeleteKeyComment(const unsigned keyID, const unsigned commentID);
+	bool     DeleteKeyComment(const std::string & keyname, const unsigned commentID);
+	
 	// Delete all comments for a key.
-	bool     DeleteKeyComments( const unsigned keyID);																				// tolua_export
-	bool     DeleteKeyComments( const std::string & keyname);																			// tolua_export
-};	// tolua_export
+	bool     DeleteKeyComments(const unsigned keyID);
+	bool     DeleteKeyComments(const std::string & keyname);
+};
+
+// tolua_end
 
 #endif