teleport/common/libex/include/ex/ex_ini.h

#ifndef __EX_INI_H__
#define __EX_INI_H__

/*
特别注意：

1. 以 分号';' 或者 井号'#' 作为注释行的第一个字符
2. 不支持行内注释
3. 值对以第一个等号分隔，等号前后如果有空格会被忽略，之后的空格会保留，包括行尾空格
4. 如果有不属于某个小节的值对，可以使用GetDumySection()获取
   DumySection主要是为了能够兼容简单的Python文件做配置文件。
*/

#include "ex_str.h"
#include <map>

typedef std::map<ex_wstr, ex_wstr> ex_ini_kvs;

class ExIniSection
{
public:
	ExIniSection();
	ExIniSection(const ex_wstr& strSectionName);
	~ExIniSection();

	void ClearUp(void);

	ex_wstr Name(void) { return m_strName; }

	void GetStr(const ex_wstr& strKey, ex_wstr& strValue, const ex_wstr& strDefault);
	bool GetStr(const ex_wstr& strKey, ex_wstr& strValue);

	void GetInt(const ex_wstr& strKey, int& iValue, int iDefault);
	bool GetInt(const ex_wstr& strKey, int& iValue);

	void GetBool(const ex_wstr& strKey, bool& bValue, bool bDefault);
	bool GetBool(const ex_wstr& strKey, bool& bValue);
	
	bool SetValue(const ex_wstr& strKey, const ex_wstr& strValue, bool bAddIfNotExists = false);

	ex_ini_kvs& GetKeyValues(void) { return m_kvs; }

	int Count(void) const
	{
		return (int)m_kvs.size();
	}
	void Save(FILE* file, int codepage);
#ifdef EX_DEBUG
	void Dump(void);
#endif

protected:
	bool _IsKeyExists(const ex_wstr& strKey);

private:
	ex_wstr m_strName;
	ex_ini_kvs m_kvs;
};


typedef std::map<ex_wstr, ExIniSection*> ex_ini_sections;

// Ini file
class ExIniFile
{
public:
	enum PARSE_RV
	{
		PARSE_ERROR,
		PARSE_SECTION,
		PARSE_KEYVALUE,
		PARSE_COMMENT,
		PARSE_OTHER
	};

public:
	ExIniFile();
	~ExIniFile();

	const ex_wstr& get_filename(void){return m_file_path;}

	void ClearUp(void);

	// Read and parse special file.
	bool LoadFromFile(const ex_wstr& strFileName, bool bClearOld = true);
	bool LoadFromMemory(const ex_wstr& strData, bool bClearOld = true);

	ex_ini_sections& GetAllSections(void) { return m_secs; }

	ExIniSection* GetSection(const ex_wstr& strName, bool bCreateIfNotExists = false);
	ExIniSection* GetDumySection(void) { return &m_dumy_sec; }

	int Count(void) const
	{
		return (int)(m_secs.size());
	}
	void Save(int codepage = EX_CODEPAGE_UTF8);
#ifdef EX_DEBUG
	void Dump(void);
#endif

protected:
	static PARSE_RV _ParseLine(const ex_wstr& strLine, ex_wstr& strKey, ex_wstr& strValue);
	bool _ProcessLine(const ex_wstr strLine, ExIniSection** pCurSection);

private:
	ex_ini_sections m_secs;
	ExIniSection m_dumy_sec;
	ex_wstr m_file_path;
};

#endif // __EX_INI_H__